ReferenceProducts
List products
Required scope
products:readThe API key must hold this scope, otherwise Kivoo answers 403 insufficient_scope.GET
/v1/productsEvery product of the store, whatever its status, newest first. q searches the title.
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 <= 100status?string
Value in
- "DRAFT"
- "PUBLISHED"
- "ARCHIVED"
type?string
Value in
- "FILE"
- "COURSE"
- "LICENSE"
- "MEETING"
- "EVENT"
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://api.kivoo.africa/v1/products" \ -H "Authorization: Bearer kv_live_EXAMPLE0000000000000000000000000000000000"{ "page": 1, "pageSize": 25, "total": 42, "data": [ { "id": "3a6c2f1e-8b4d-4c1a-9e2f-5d7b8a9c0e1f", "title": "Guide du freelance", "slug": "guide-du-freelance-a3f9k2p1", "type": "FILE", "status": "PUBLISHED", "summary": "Trouver ses premiers clients en trente jours.", "description": "<p>Un guide pas à pas.</p>", "priceAmount": 5000, "compareAtAmount": 7500, "currency": "XAF", "url": "https://atelier-nour.kivoo.store/guide-du-freelance-a3f9k2p1", "coverUrl": "https://api.kivoo.africa/api/v1/products/3a6c2f1e-8b4d-4c1a-9e2f-5d7b8a9c0e1f/cover?v=cover.jpg", "publishedAt": "2026-09-01T08:00:00.000Z", "createdAt": "2026-08-28T15:12:00.000Z", "updatedAt": "2026-09-01T08:00:00.000Z" } ]}