ReferenceLicense keys
Validate a license key
Required scope
license_keys:readThe API key must hold this scope, otherwise Kivoo answers 403 insufficient_scope.POST
/v1/license-keys/validateWhatever its state, the key comes back with 200: open your software when isActive is true, and tell its user why from status otherwise. Keep the answer up to 24 hours on your server. 600 requests a minute per API key, apart from the other routes.
Authorization
apiKey AuthorizationBearer <token>
An API key of the store, kv_live_…
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://api.kivoo.africa/v1/license-keys/validate" \ -H "Authorization: Bearer kv_live_EXAMPLE0000000000000000000000000000000000" \ -H "Content-Type: application/json" \ -d '{ "key": "BAU-XKCD-92HF-LM7P-Q4RT" }'{ "id": "1c2d3e4f-5a6b-4c7d-8e9f-0a1b2c3d4e5f", "keyHint": "BAU-…-Q4RT", "status": "active", "isActive": true, "issuedAt": "2026-10-15T09:12:00.000Z", "expiresAt": "2026-11-14T09:12:00.000Z", "revokedAt": null, "activations": { "count": 1, "max": 1, "remaining": 0 }, "product": { "id": "9e8d7c6b-5a4f-4e3d-8c2b-1a0f9e8d7c6b", "title": "Bauhaus Pro" }, "customer": { "id": "2b3c4d5e-6f7a-4b8c-9d0e-1f2a3b4c5d6e", "email": "awa@example.com" }, "order": { "id": "4d5e6f7a-8b9c-4d0e-8f2a-3b4c5d6e7f8a", "reference": "KV-7F3K9QA2" }, "checkout": { "id": "8a7b6c5d-4e3f-4a1b-9c0d-1e2f3a4b5c6d", "externalReference": "42", "metadata": { "plan": "pro" } }, "key": "BAU-XKCD-92HF-LM7P-Q4RT"}