Categories
Get Categories
Learn how to list a store’s categories using the GET /stores//categories endpoint.
GET
List categories
📌 Endpoint
GET /stores/{storeId}/categories
Returns all categories of a store.
Categories are returned in position order (ascending), ideal for building menus/listings in the frontend.
🔐 Authentication
- Public route for queries.
- The store linked to
storeIdmust have an active plan.
🧾 Route parameters
✅ Request example
🔎 Query params
🔄 Cursor pagination
For large lists (more than ~100 items), prefer cursor pagination instead ofpage:
- Make the first call without
cursor. - If
hasMoreistrue, the response includes thenextCursorfield. - Send that
nextCursorin thecursorparameter of the next request to fetch the next page.
nextCursor, hasMore and limit:
cursorandpagecannot be used together (400 INVALID_PAGINATION).- When there are no categories, offset mode (without
cursor) returns404 CATEGORIES_NOT_FOUND, whereas cursor mode returns200withcategories: [],nextCursor: null, andhasMore: false. nextCursor: nullwithhasMore: falseindicate the end of the list (the API responds200with an empty array).
📦 Success response (200)
The first call (withoutcursor) already returnsnextCursorandhasMorein the pagination, allowing cursor pagination to start without extra calls.
⚠️ Possible errors
400 INVALID_DATA→ invalid parameter400 INVALID_PAGINATION_LIMIT→limitoutside the allowed range (1to100)400 INVALID_PAGINATION_PAGE→ invalidpage400 INVALID_PAGINATION_CURSOR→ invalid or malformedcursor400 INVALID_PAGINATION→pageandcursorused together401 UNAUTHENTICATED→ could not identify the subscription user403 NO_ACTIVE_SUBSCRIPTION→ inactive or expired plan404 STORE_NOT_FOUND→ store not found404 CATEGORIES_NOT_FOUND→ no categories found (returned only in offset mode whentotalis0; cursor mode returns200with[])429 RATE_LIMIT_EXCEEDED→ rate limit per minute exceeded500 INTERNAL_SERVER_ERROR→ internal server error503 SERVICE_UNAVAILABLE→ service or database unavailable