Products
List products
GET
Lists the store's products, newest first, each with its variants, prices and stock. Deleted products and variants are left out. Filter by status, type, SKU or date.
apiKeyheader
AuthorizationBearer <token>A store API key from Settings → Developers → API keys, sent as Authorization: Bearer zk_live_….
limit?integerPage size, 1–100
Range
1 <= value <= 100Default
25cursor?stringnext_cursor from the previous page
Length
length <= 500order?stringSort by created_at; newest first by default
Default
"desc"Value in
"desc""asc"created_after?stringOnly records created after this time
Format
date-timecreated_before?stringOnly records created before this time
Format
date-timeupdated_after?stringOnly records changed after this time — poll with your last sync time
Format
date-timeupdated_before?stringOnly records changed before this time
Format
date-timestatus?stringValue in
"pending""approved""deleted""archived""featured""in_review""draft"type?stringValue in
"physical""digital""consulting""webinar"sku?stringOnly products with a variant of this exact SKU
Length
length <= 100Success
application/json- response
object*"list"Value in
"list"data*array<>has_more*booleanWhether another page exists
next_cursor*stringPass as cursor to get the next page; null on the last
curl -X GET "https://example.com/products"{ "object": "list", "data": [ { "object": "product", "id": "00000000-0000-4000-8000-0000000000a1", "name": "Classic T-shirt", "slug": "classic-t-shirt", "type": "physical", "status": "approved", "currency": "SAR", "min_price": "108.00", "max_price": "108.00", "category_id": null, "tags": [ "summer" ], "images": [ "https://cdn.example.com/products/classic-t-shirt.jpg" ], "translations": [ { "locale": "en", "name": "Classic T-shirt", "description": "100% cotton." }, { "locale": "ar", "name": "تيشيرت كلاسيكي", "description": "قطن ١٠٠٪." } ], "variants": [ { "object": "product_variant", "id": "00000000-0000-4000-8000-0000000000b1", "product_id": "00000000-0000-4000-8000-0000000000a1", "title": "Medium / Black", "sku": "TSHIRT-M-BLK", "barcode": null, "price": "120.00", "discount_type": "percentage", "discount_value": "10.00", "stock": 42, "low_stock_threshold": 5, "option1": "Medium", "option2": "Black", "option3": null, "position": 1, "image_url": null, "created_at": "2026-09-01T08:00:00.000Z", "updated_at": "2026-10-01T09:30:00.000Z" } ], "created_at": "2026-09-01T08:00:00.000Z", "updated_at": "2026-10-01T09:30:00.000Z" } ], "has_more": false, "next_cursor": null}