List license keys

Portée requiselicense_keys:readLa clé API doit porter cette portée, sinon Kivoo répond 403 insufficient_scope.
GET/v1/license-keys

Keys of the store, newest first, masked: keyHint, never the value. email and externalReference find the keys of one buyer.

Autorisation

apiKey
AuthorizationBearer <clé API>

An API key of the store, kv_live_…

Dans: header

Paramètres de requête

page?number

Page to return, from 1

Plage1 <= value
Par défaut1
pageSize?number

Items per page, 1 to 100

Plage1 <= value <= 100
Par défaut25
productId?string

Only the keys of this license

Formatuuid
status?string

Only this status

Valeur parmi

  • "active"
  • "pending"
  • "expired"
  • "revoked"
email?string

Only the keys of the buyer with this email, case-insensitive

Formatemail
externalReference?string

Only the keys sold by a checkout session with this external reference

Longueurlength <= 255

Corps de la réponse

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"        }      }    }  ]}