List checkout sessions
Portée requise
checkouts:readLa clé API doit porter cette portée, sinon Kivoo répond 403 insufficient_scope.GET
/v1/checkoutsSessions of the store, newest first. externalReference finds those of one of your users.
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
Plage
1 <= valuePar défaut
1pageSize?number
Items per page, 1 to 100
Plage
1 <= value <= 100Par défaut
25externalReference?string
Only the sessions of this external reference
Longueur
length <= 255status?string
Only this status
Valeur parmi
- "open"
- "paid"
- "expired"
productId?string
Only the sessions of this license
Format
uuidCorps de la réponse
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://api.kivoo.africa/v1/checkouts" \ -H "Authorization: Bearer kv_live_EXAMPLE0000000000000000000000000000000000"{ "page": 1, "pageSize": 25, "total": 42, "data": [ { "id": "7a8b9c0d-1e2f-4a3b-8c4d-5e6f7a8b9c0d", "url": "https://atelier-nour.kivoo.co/checkout/Xk2Lp9QwRt5vZb8NcY3mHs7JdF4gA6eU", "status": "open", "expiresAt": "2026-10-19T09:12:00.000Z", "product": { "id": "9e8d7c6b-5a4f-4e3d-8c2b-1a0f9e8d7c6b", "title": "Plan Pro — 30 jours" }, "amount": 4500, "currency": "XAF", "externalReference": "42", "metadata": { "plan": "pro", "workspace": "acme" }, "returnUrl": "https://app.example.com/billing/return", "customer": { "email": "awa@example.com", "lastName": "Diallo", "firstName": "Awa" }, "country": "GA", "order": null, "licenseKey": null, "createdAt": "2026-10-18T09:12:00.000Z" } ]}