ReferenceLicense keys
List license keys
Required scope
license_keys:readThe API key must hold this scope, otherwise Kivoo answers 403 insufficient_scope.GET
/v1/license-keysKeys of the store, newest first, masked: keyHint, never the value. email and externalReference find the keys of one buyer.
Authorization
apiKey AuthorizationBearer <token>
An API key of the store, kv_live_…
In: header
Query Parameters
page?number
Page to return, from 1
Range
1 <= valueDefault
1pageSize?number
Items per page, 1 to 100
Range
1 <= value <= 100Default
25productId?string
Only the keys of this license
Format
uuidstatus?string
Only this status
Value in
- "active"
- "pending"
- "expired"
- "revoked"
email?string
Only the keys of the buyer with this email, case-insensitive
Format
emailexternalReference?string
Only the keys sold by a checkout session with this external reference
Length
length <= 255Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://api.kivoo.africa/v1/license-keys" \ -H "Authorization: Bearer kv_live_EXAMPLE0000000000000000000000000000000000"{ "page": 1, "pageSize": 25, "total": 42, "data": [ { "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" } } } ]}