Plumtier Docs Deploy free

Validate a key

Check that a key, and optionally one device's activation, is still good.

POST/api/v1/licenses/validate

Doesn't use an activation. Call it on launch, at most once a day. With instance_id, it also confirms that this device's activation still exists and records when it was last seen.

Request

license_keystringrequired

The key.

instance_idstringoptional

The instance.id you got from activate. Send it to check this device, not just the key.

product_idstringoptional

Your product's link or id. When sent, a key for a different product is not valid.

curl https://shop.example.com/api/v1/licenses/validate \
  -d license_key="7KQ2M-XW9PA-4TB8N-R2HDE" \
  -d instance_id="inst_8fq2…" \
  -d product_id="pastepal"

Response

200, with valid saying whether to unlock. A disabled, expired or wrong-product key is still 200, with valid: false and an error: check valid, not the status code.

200 OK
{
  "valid": true,
  "error": null,
  "license_key": {
    "id": "lic_3k9x…",
    "status": "active",
    "key": "7KQ2M-XW9PA-4TB8N-R2HDE",
    "activation_limit": 3,
    "activation_usage": 1,
    "created_at": "2026-11-17T09:51:52.000Z",
    "expires_at": null
  },
  "instance": {
    "id": "inst_8fq2…",
    "name": "Ada's MacBook Pro",
    "created_at": "2026-11-17T09:55:01.000Z"
  },
  "meta": {
    "store_id": "4b1c…",
    "order_id": "ord_q3fq…",
    "order_number": 1042,
    "product_id": "prod_s64g…",
    "product_name": "PastePal",
    "variant_id": "var_82vd…",
    "variant_name": "Family",
    "customer_id": "cus_ea3j…",
    "customer_name": "Ada Lovelace",
    "customer_email": "ada@example.com"
  }
}
200 OK, not valid
{
  "valid": false,
  "error": "This license key has been disabled.",
  "instance": { "id": "inst_8fq2…", "name": "Ada's MacBook Pro", "created_at": "2026-11-17T09:55:01.000Z" },
  "license_key": { "status": "disabled", "…": "…" },
  "meta": { "…": "…" }
}

If instance_id doesn't belong to this key (for example the buyer freed this device from their purchases), the answer is 404 with valid: false. Ask the user to activate again.