KivooDeveloper
GuidesRéférenceWebhooksDashboardkivoo.africa

List customers

Portée requisecustomers:readLa clé API doit porter cette portée, sinon Kivoo répond 403 insufficient_scope.
GET/v1/customers

Buyers of the store, newest first, with their totals. q searches the name, the email and the phone.

Autorisation

apiKey
AuthorizationBearer <clé API>

Clé API de la boutique, 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
q?string

Case-insensitive search

Longueurlength <= 100

Corps de la réponse

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.kivoo.africa/v1/customers" \  -H "Authorization: Bearer kv_live_EXAMPLE0000000000000000000000000000000000"
{  "page": 1,  "pageSize": 25,  "total": 42,  "data": [    {      "id": "7d9e1f2a-3b4c-4d5e-8f6a-7b8c9d0e1f2a",      "name": "Aminata Diallo",      "email": "aminata@example.com",      "phone": "+237655000000",      "ordersCount": 3,      "totalPaid": 15000,      "currency": "XAF",      "createdAt": "2026-09-12T10:03:00.000Z"    }  ]}