Categories
Get Products by Category
How to list the public products of a specific category using the GET /stores//categories//products endpoint.
GET
List products by category
๐ Endpoint
GET /stores/{storeId}/categories/{categoryId}/products
Returns the public (not disabled) products that belong to a category of a store.
Products are returned in position order (ascending).
๐ Authentication
- Public route for queries.
- The store must exist and 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 products in the category, offset mode (without
cursor) returns404 PRODUCTS_NOT_FOUND, whereas cursor mode returns200withproducts: [],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 PRODUCTS_NOT_FOUNDโ no products found for the category (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