Products
List Products
Learn how to list products from a store using the endpoint GET /stores//products.
GET
List products
📌 Endpoint
GET /stores/{storeId}/products
Returns all products from a store.
Products are returned in position order (ascending).
Products with disabled: true may appear in the response for use in the admin/panel.
🔐 Authentication
- Public route for queries.
- The store must exist and have an active plan.
🧾 Route parameters
✅ Example request
🔎 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).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 PRODUCTS_NOT_FOUND→ no products registered (in offset mode whentotalis0; cursor mode returns200with[])429 RATE_LIMIT_EXCEEDED→ rate limit per minute exceeded500 INTERNAL_SERVER_ERROR→ internal error503 SERVICE_UNAVAILABLE→ service or database unavailable