Storefront APIsProducts
List products
Returns a paginated list of active products. Supports filtering, searching, and sorting. Only active products are returned — draft and deleted products are never included.
Path Parameters
storeId*string
Store ID (shp_ prefix)
Query Parameters
page?integer
Page number
Range
1 <= valueDefault
1limit?integer
Items per page
Range
1 <= value <= 100Default
25search?string
Full-text search on product title
categoryId?string
Filter by category ID
productType?string
Filter by product type
Value in
- "SERIAL"
- "SERVICE"
- "ONE_TIME"
- "PHYSICAL"
- "SUBSCRIPTION"
- "DIGITAL_DOWNLOAD"
- "LICENSE_KEY"
pricingModel?string
Filter by pricing model
Value in
- "STANDARD"
- "PAY_WHAT_YOU_WANT"
- "FREE"
sortBy?string
Sort field
Default
"createdAt"Value in
- "title"
- "price"
- "createdAt"
sortOrder?string
Sort direction
Default
"desc"Value in
- "asc"
- "desc"
Response Body
application/json
application/json
curl -X GET "https://example.com/stores/string/products"{ "ok": true, "data": { "items": [ { "id": "string", "title": "string", "subtitle": "string", "handle": "string", "price": 0, "compareAtPrice": 0, "images": [ "string" ], "inStock": true, "currency": "string", "productType": "SERIAL", "pricingModel": "STANDARD", "status": "ACTIVE", "minimumPrice": 0, "categories": [ { "id": "string", "name": "string", "slug": "string" } ] } ], "pagination": { "page": 0, "limit": 0, "total": 0, "totalPages": 0 } }}