KivooDeveloper
GuidesRéférenceWebhooksDashboardkivoo.africa

List products

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

Every product of the store, whatever its status, newest first. q searches the title.

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
status?string

Valeur parmi

  • "DRAFT"
  • "PUBLISHED"
  • "ARCHIVED"
type?string

Valeur parmi

  • "FILE"
  • "COURSE"
  • "LICENSE"
  • "MEETING"
  • "EVENT"

Corps de la réponse

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