Licenses API

Manage product licenses programmatically.

List Licenses

Get all licenses for the authenticated user.

GET /api/licenses

Response:

[
  {
    "id": "uuid",
    "key": "ECO-XXXX-XXXX-XXXX",
    "productId": "uuid",
    "status": "active",
    "activationsCount": 1,
    "activationsLimit": 3,
    "expiresAt": "2027-02-16T00:00:00Z",
    "createdAt": "2026-02-16T00:00:00Z"
  }
]

Validate a License

Check if a license key is valid.

POST /api/licenses/validate
Content-Type: application/json

{
  "key": "ECO-XXXX-XXXX-XXXX",
  "domain": "mysite.com"
}

Response:

{
  "valid": true,
  "license": {
    "key": "ECO-XXXX-XXXX-XXXX",
    "status": "active",
    "expiresAt": "2027-02-16T00:00:00Z"
  }
}

Activate a License

Register a domain/installation against a license.

POST /api/licenses/activate
Content-Type: application/json

{
  "key": "ECO-XXXX-XXXX-XXXX",
  "domain": "mysite.com"
}

Response:

{
  "activated": true,
  "activationsCount": 2,
  "activationsLimit": 3
}

Deactivate a License

Remove a domain/installation from a license.

POST /api/licenses/deactivate
Content-Type: application/json

{
  "key": "ECO-XXXX-XXXX-XXXX",
  "domain": "mysite.com"
}

Response:

{
  "deactivated": true,
  "activationsCount": 1
}

Error Responses

Error	Meaning
License not found	The key doesn't exist
License expired	The license has passed its expiration date
Activation limit reached	All activation slots are used
License revoked	The license was manually revoked