CycleCore Docs
API publiqueReference APIEndpoints

Lister les categories

GET
/public/v1/categories

Retourne les categories de l'organisation rattachee a la cle API.

Authorization

BearerAuth
AuthorizationBearer <token>

Utilisez le format : Bearer ccpk_xxxxx

In: header

Query Parameters

page?integer

Page de resultats.

perPage?integer

Nombre maximum d'elements par page.

q?string

Terme de recherche libre.

sort?string

Tri au format champ.ordre, par exemple updatedAt.desc. Plusieurs tris peuvent etre separes par des virgules.

parentId?string

Filtre les categories par parent.

isMaster?boolean

Filtre les categories maitres.

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/public/v1/categories"
{  "data": [    {      "id": "cat_123",      "slug": "t-shirts",      "label": "T-shirts",      "parentId": null,      "isMaster": false,      "updatedAt": "2026-06-07T12:00:00.000Z"    }  ],  "pagination": {    "page": 1,    "perPage": 10,    "total": 42,    "totalPages": 5,    "hasAny": true  }}
{  "statusCode": 401,  "message": "Clé API invalide.",  "error": "Unauthorized"}
{  "statusCode": 401,  "message": "Clé API invalide.",  "error": "Unauthorized"}
{  "statusCode": 429,  "message": "Limite de requêtes dépassée.",  "error": "Too Many Requests",  "code": "PUBLIC_API_RATE_LIMIT_EXCEEDED",  "retryAfter": 60}