Licenses - Orvlin

Licenses are seats a customer holds under a license price. Allocate one for each seat you sell, and deactivate it when the seat is freed.

Allocate a license

POST /v1/licenses

{
  "customerId": "cust_acme",
  "licenseTypeId": "seats"
}

Field	Type	Required	Description
`customerId`	string	Yes	The customer who holds the seat.
`licenseTypeId`	string	Yes	The license type, matching the `licenseTypeId` of a `license` price, such as `seats`.

snake_case (customer_id, license_type_id) is also accepted. Response:

{
  "id": "lic_01JX…",
  "accountId": "acc_…",
  "customerId": "cust_acme",
  "licenseTypeId": "seats",
  "status": "active",
  "startedAt": "2026-10-12T09:30:00.000Z"
}

Deactivate a license

Frees the seat. The customer stops being billed for it from the next period.

POST /v1/licenses/:id/deactivate

Response:

{
  "success": true,
  "deactivatedAt": "2026-10-12T10:00:00.000Z"
}