ReferenceCustomers
List customers
Required scope
customers:readThe API key must hold this scope, otherwise Kivoo answers 403 insufficient_scope.GET
/v1/customersBuyers of the store, newest first, with their totals. q searches the name, the email and the phone.
Authorization
apiKey AuthorizationBearer <token>
Clé API de la boutique, 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
25q?string
Case-insensitive search
Length
length <= 100Response Body
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" } ]}