Stores
List Stores
Learn how to list all stores registered in the Cabra API using the endpoint GET /stores.
GET
List stores
🏬 List Stores
This endpoint allows you to list all stores associated with your account. Stores are returned inposition order (ascending).
It is ideal for:
- Displaying stores in administrative panels
- Integrating data with other systems
- Automating store queries
🔐 Authentication
This route requires authentication via API Key, sent in the request header:📋 Example Request
📊 Example Response (200)
The first call (withoutcursor) already returnsnextCursorandhasMorein the pagination, allowing cursor pagination to start without extra calls.
📌 Parameters
Query params
If there are no stores on the queried page,
stores is returned as an empty array.
🔄 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).nextCursor: nullwithhasMore: falseindicate the end of the list (the API responds200with an empty array).
⚠️ Possible errors
400 INVALID_PAGINATION_LIMIT→limitoutside the allowed range (1to100)400 INVALID_PAGINATION_PAGE→ invalidpage400 INVALID_PAGINATION_CURSOR→ invalid or malformedcursor400 INVALID_PAGINATION→pageandcursorused together401 API_KEY_NOT_PROVIDED→Authorizationheader not sent401 INVALID_API_KEY→ invalid or not found API Key401 UNAUTHENTICATED→ session/user not authenticated403 USER_DISABLED→ user account disabled or deleted403 NO_ACTIVE_SUBSCRIPTION→ account has no active plan429 RATE_LIMIT_EXCEEDED→ plan per-minute request limit exceeded500 INTERNAL_SERVER_ERROR→ internal error503 SERVICE_UNAVAILABLE→ service temporarily unavailable