Storefront endpoint reference
Wishlists
Lists the signed-in customer’s saved products at this store with cursor pagination (limit up to 100 + starting_after). The store’s merchant, and apps holding merchant-customers-detail, can read these saved items.
Authorization
clientKey customerToken X-Client-Key<token>
The store's API key (Dashboard → Settings → API keys). pk_live_… public keys are for browser code and only work from an origin on the key's allowlist; sk_live_… private keys are for servers and native apps and need no Origin.
In: header
AuthorizationBearer <token>
The customer access credential from any sign-in session answer (access_token). Account operations only — send as Authorization: Bearer <access_token> ALONGSIDE X-Client-Key. It is bound to one store: a credential issued for another vendor answers 403 here.
In: header
Query Parameters
limit?|
Range
1 <= value <= 100starting_after?string|null
locale?string
Render this read in a published store locale (see GET store/locales). Unknown or unpublished codes fall back to the primary locale; the answer carries the locale used in Content-Language.
Header Parameters
X-Client-Key*string
Your store API key (Dashboard → Settings → API keys). pk_live_… public keys are for browser code and only work from an origin on the key's allowlist; sk_live_… private keys are for servers and native apps and need no Origin.
X-Request-Id?string
Your own correlation id (8–128 chars, ^[A-Za-z0-9_.:-]+$). Echoed back on the response and on every log line of the request; one is generated when you omit it.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/store/wishlist-items?limit=2&starting_after=WzEsIjkzNDkxZTc2ZDBmYzk5N2Q0ZjI3NjFlNGUzNzFhZTY0YjgyZWZhMDE4NzM4NjQ5MDM1NzBjMzhmNWUxMDIwZDIiLCJleUpqZFhOMGIyMWxjbDkzYVhOb2JHbHpkRjlwZEdWdGN5NWpjbVZoZEdWa1gyRjBJam9pTWpBeU5pMHdPUzB5TUNBeE1Eb3dNRG93TUNJc0ltTjFjM1J2YldWeVgzZHBjMmhzYVhOMFgybDBaVzF6TG1sa0lqb2lNREU1WWpCak5HUXROV1UyWmkwM1lUaGlMVGxqTUdRdE1XVXlaak5oTkdJMVl6azVJaXdpWDNCdmFXNTBjMVJ2VG1WNGRFbDBaVzF6SWpwMGNuVmxmUSJd" \ -H "X-Client-Key: {{clientKey}}"{ "status": "success", "message": "Wishlist items retrieved", "data": [ { "created_at": "2026-09-20T09:00:00.000000Z", "product": { "shop_id": "019b0c4d-5e6f-7a8b-9c0d-1e2f3a4b5c01", "id": "019b0c4d-5e6f-7a8b-9c0d-1e2f3a4b5c11", "p_id": 31501, "title": "Ankara Midi Dress", "slug": "ankara-midi-dress", "excerpt": "Flared ankara midi with pockets, cut in Lagos.", "description": "Our signature flared midi in premium cotton ankara, with side pockets and a concealed back zip. Cut and finished in our Lekki atelier.", "image": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-view.webp", "thumbnail_image": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-thumb.webp", "video_url": null, "video_poster_url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-view.webp", "type": "product", "commerce_mode": "shop", "currency": "NGN", "price": 28500, "discount_price": 24225, "compare_at_price": 28500, "is_price_from": false, "price_range": { "min": 28500, "max": 28500 }, "has_variants": true, "has_addons": false, "tax_inclusive": false, "discount": { "id": "019b0c4d-5e6f-7a8b-9c0d-1e2f3a4b5c31", "title": "Lagos Fashion Week 15% Off", "type": "percentage", "value": 15, "amount": 4275, "final_price": 24225, "image_url": "https://media.usequeek.com/uploads/stores/2207/discounts/fashion-week.jpg" }, "discounts": [ { "id": "019b0c4d-5e6f-7a8b-9c0d-1e2f3a4b5c31", "title": "Lagos Fashion Week 15% Off", "type": "percentage", "value": 15, "amount": 4275, "final_price": 24225, "image_url": "https://media.usequeek.com/uploads/stores/2207/discounts/fashion-week.jpg" } ], "media": { "thumbnail": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-thumb.webp", "image": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-view.webp", "original": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress.jpg", "primary_variant_image": null, "image_variants": { "thumb": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-thumb.webp", "w": null, "h": null }, "card": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-card.webp", "w": 480, "h": 600 }, "card2x": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-card2x.webp", "w": 800, "h": 1000 }, "view": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-view.webp", "w": 1200, "h": 1500 }, "wa": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-wa.jpg", "w": 1080, "h": 1350 }, "original": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress.jpg", "w": 1200, "h": 1500 } }, "primary_variant_image_variants": null, "images": [ { "id": 77101, "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-card.webp", "alt": "Ankara midi dress on a mannequin", "variants": { "thumb": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-thumb.webp", "w": null, "h": null }, "card": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-card.webp", "w": 480, "h": 600 }, "card2x": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-card2x.webp", "w": 800, "h": 1000 }, "view": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-view.webp", "w": 1200, "h": 1500 }, "wa": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-wa.jpg", "w": 1080, "h": 1350 }, "original": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress.jpg", "w": 1200, "h": 1500 } } }, { "id": 77103, "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back-card.webp", "alt": "Ankara midi dress, back view", "variants": { "thumb": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back-thumb.webp", "w": null, "h": null }, "card": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back-card.webp", "w": 480, "h": 600 }, "card2x": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back-card2x.webp", "w": 800, "h": 1000 }, "view": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back-view.webp", "w": 1200, "h": 1500 }, "wa": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back-wa.jpg", "w": 1080, "h": 1350 }, "original": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back.jpg", "w": 1200, "h": 1500 } } } ], "video_url": null, "video_poster_url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-view.webp" }, "inventory": { "in_stock": true, "tracking": true, "quantity": 18, "allow_backorder": false, "low_stock_threshold": 5, "updated_at": "2026-09-22 16:05:00" }, "variant_summary": { "count": 3, "min_price": 28500, "max_price": 28500, "total_stock": 18, "tracks_inventory": true, "in_stock": true }, "variants_count": 3, "rating": 4.8, "review_count": 14, "flags": { "featured": false, "is_marketplace": false, "is_wholesale": false, "is_new": false }, "metafields": {}, "created_at": "2026-06-18 09:40:00", "updated_at": "2026-09-22 16:05:00", "shop": { "id": "019b0c4d-5e6f-7a8b-9c0d-1e2f3a4b5c01", "name": "Zuri Atelier", "slug": "zuri-atelier", "logo": "https://media.usequeek.com/uploads/stores/2207/logo.png", "rating": 4.7, "rating_count": 486 }, "addons": [], "taxonomy": { "categories": [ { "id": "019b0c4d-5e6f-7a8b-9c0d-1e2f3a4b5c21", "name": "Dresses", "slug": "dresses" } ], "tags": [], "brand": null, "collections": [ { "id": "019b0c4d-5e6f-7a8b-9c0d-1e2f3a4b5c25", "name": "New Season", "slug": "new-season", "mode": "manual" } ] }, "purchase_limits": { "min_qty": 1, "max_qty": null, "step_qty": 1 }, "measurement": { "weight": { "value": 0.5, "unit": "kg" }, "dimensions": null }, "specs": [], "options": [ { "name": "Size", "type": "size", "values": [ "S", "M", "L" ], "values_detailed": [ { "value": "S", "color_code": null, "image": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress.jpg" }, { "value": "M", "color_code": null, "image": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress.jpg" }, { "value": "L", "color_code": null, "image": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress.jpg" } ] } ], "variants": [ { "id": "019b0c4d-5f10-7a02-8c61-0b2d4e6f8a01", "sku": "ZRA-AMD-S", "title": "S", "option_values": { "Size": "S" }, "price": 28500, "discount_price": 24225, "discount_amount": 4275, "has_discount": true, "compare_at_price": null, "stock": 6, "track_inventory": true, "is_active": true, "in_stock": true, "weight": 0.4, "position": 0, "media": { "thumbnail": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress.jpg", "image": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress.jpg", "image_media_id": null, "image_variants": { "thumb": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-thumb.webp", "w": null, "h": null }, "card": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-card.webp", "w": 480, "h": 600 }, "card2x": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-card2x.webp", "w": 800, "h": 1000 }, "view": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-view.webp", "w": 1200, "h": 1500 }, "wa": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-wa.jpg", "w": 1080, "h": 1350 }, "original": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress.jpg", "w": 1200, "h": 1500 } }, "images": [ { "id": 77101, "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-card.webp", "alt": "Ankara midi dress on a mannequin", "variants": { "thumb": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-thumb.webp", "w": null, "h": null }, "card": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-card.webp", "w": 480, "h": 600 }, "card2x": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-card2x.webp", "w": 800, "h": 1000 }, "view": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-view.webp", "w": 1200, "h": 1500 }, "wa": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-wa.jpg", "w": 1080, "h": 1350 }, "original": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress.jpg", "w": 1200, "h": 1500 } } }, { "id": 77103, "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back-card.webp", "alt": "Ankara midi dress, back view", "variants": { "thumb": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back-thumb.webp", "w": null, "h": null }, "card": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back-card.webp", "w": 480, "h": 600 }, "card2x": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back-card2x.webp", "w": 800, "h": 1000 }, "view": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back-view.webp", "w": 1200, "h": 1500 }, "wa": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back-wa.jpg", "w": 1080, "h": 1350 }, "original": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back.jpg", "w": 1200, "h": 1500 } } } ], "video_url": null, "source": "product" } }, { "id": "019b0c4d-5f10-7a02-8c61-0b2d4e6f8a02", "sku": "ZRA-AMD-M", "title": "M", "option_values": { "Size": "M" }, "price": 28500, "discount_price": 24225, "discount_amount": 4275, "has_discount": true, "compare_at_price": null, "stock": 8, "track_inventory": true, "is_active": true, "in_stock": true, "weight": 0.45, "position": 1, "media": { "thumbnail": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress.jpg", "image": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress.jpg", "image_media_id": null, "image_variants": { "thumb": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-thumb.webp", "w": null, "h": null }, "card": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-card.webp", "w": 480, "h": 600 }, "card2x": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-card2x.webp", "w": 800, "h": 1000 }, "view": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-view.webp", "w": 1200, "h": 1500 }, "wa": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-wa.jpg", "w": 1080, "h": 1350 }, "original": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress.jpg", "w": 1200, "h": 1500 } }, "images": [ { "id": 77101, "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-card.webp", "alt": "Ankara midi dress on a mannequin", "variants": { "thumb": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-thumb.webp", "w": null, "h": null }, "card": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-card.webp", "w": 480, "h": 600 }, "card2x": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-card2x.webp", "w": 800, "h": 1000 }, "view": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-view.webp", "w": 1200, "h": 1500 }, "wa": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-wa.jpg", "w": 1080, "h": 1350 }, "original": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress.jpg", "w": 1200, "h": 1500 } } }, { "id": 77103, "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back-card.webp", "alt": "Ankara midi dress, back view", "variants": { "thumb": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back-thumb.webp", "w": null, "h": null }, "card": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back-card.webp", "w": 480, "h": 600 }, "card2x": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back-card2x.webp", "w": 800, "h": 1000 }, "view": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back-view.webp", "w": 1200, "h": 1500 }, "wa": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back-wa.jpg", "w": 1080, "h": 1350 }, "original": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back.jpg", "w": 1200, "h": 1500 } } } ], "video_url": null, "source": "product" } }, { "id": "019b0c4d-5f10-7a02-8c61-0b2d4e6f8a03", "sku": "ZRA-AMD-L", "title": "L", "option_values": { "Size": "L" }, "price": 28500, "discount_price": 24225, "discount_amount": 4275, "has_discount": true, "compare_at_price": null, "stock": 4, "track_inventory": true, "is_active": true, "in_stock": true, "weight": 0.5, "position": 2, "media": { "thumbnail": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress.jpg", "image": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress.jpg", "image_media_id": null, "image_variants": { "thumb": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-thumb.webp", "w": null, "h": null }, "card": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-card.webp", "w": 480, "h": 600 }, "card2x": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-card2x.webp", "w": 800, "h": 1000 }, "view": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-view.webp", "w": 1200, "h": 1500 }, "wa": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-wa.jpg", "w": 1080, "h": 1350 }, "original": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress.jpg", "w": 1200, "h": 1500 } }, "images": [ { "id": 77101, "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-card.webp", "alt": "Ankara midi dress on a mannequin", "variants": { "thumb": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-thumb.webp", "w": null, "h": null }, "card": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-card.webp", "w": 480, "h": 600 }, "card2x": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-card2x.webp", "w": 800, "h": 1000 }, "view": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-view.webp", "w": 1200, "h": 1500 }, "wa": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-wa.jpg", "w": 1080, "h": 1350 }, "original": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress.jpg", "w": 1200, "h": 1500 } } }, { "id": 77103, "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back-card.webp", "alt": "Ankara midi dress, back view", "variants": { "thumb": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back-thumb.webp", "w": null, "h": null }, "card": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back-card.webp", "w": 480, "h": 600 }, "card2x": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back-card2x.webp", "w": 800, "h": 1000 }, "view": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back-view.webp", "w": 1200, "h": 1500 }, "wa": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back-wa.jpg", "w": 1080, "h": 1350 }, "original": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back.jpg", "w": 1200, "h": 1500 } } } ], "video_url": null, "source": "product" } } ], "fulfillment": { "type": "delivery_or_pickup", "is_digital": false, "delivery_available": true, "pickup_available": true, "lead_time_min": null, "lead_time_max": null }, "compliance": { "warranty_months": 0, "country_of_origin": null, "safety_notes": null }, "seo": { "meta_title": null, "meta_description": null, "canonical_url": null, "keywords": [] }, "analytics": { "sales_count": 31, "view_count": 218, "favorite_count": 0, "review_count": 14 } }, "variant": { "id": "019b0c4d-5f10-7a02-8c61-0b2d4e6f8a02", "p_id": 44102, "title": "M", "option_values": { "Size": "M" } } } ], "has_more": false, "next_cursor": null}Saves a published product or matching active variant for the signed-in customer. The store’s merchant, and apps holding merchant-customers-detail, can read saved items.
Authorization
clientKey customerToken X-Client-Key<token>
The store's API key (Dashboard → Settings → API keys). pk_live_… public keys are for browser code and only work from an origin on the key's allowlist; sk_live_… private keys are for servers and native apps and need no Origin.
In: header
AuthorizationBearer <token>
The customer access credential from any sign-in session answer (access_token). Account operations only — send as Authorization: Bearer <access_token> ALONGSIDE X-Client-Key. It is bound to one store: a credential issued for another vendor answers 403 here.
In: header
Header Parameters
X-Client-Key*string
Your store API key (Dashboard → Settings → API keys). pk_live_… public keys are for browser code and only work from an origin on the key's allowlist; sk_live_… private keys are for servers and native apps and need no Origin.
X-Request-Id?string
Your own correlation id (8–128 chars, ^[A-Za-z0-9_.:-]+$). Echoed back on the response and on every log line of the request; one is generated when you omit it.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/store/wishlist-items" \ -H "X-Client-Key: {{clientKey}}" \ -H "Content-Type: application/json" \ -d '{ "product": "ankara-midi-dress", "variant": "44102" }'{ "status": "success", "message": "Wishlist item saved", "data": { "created_at": "2026-09-20T09:00:00.000000Z", "product": { "shop_id": "019b0c4d-5e6f-7a8b-9c0d-1e2f3a4b5c01", "id": "019b0c4d-5e6f-7a8b-9c0d-1e2f3a4b5c11", "p_id": 31501, "title": "Ankara Midi Dress", "slug": "ankara-midi-dress", "excerpt": "Flared ankara midi with pockets, cut in Lagos.", "description": "Our signature flared midi in premium cotton ankara, with side pockets and a concealed back zip. Cut and finished in our Lekki atelier.", "image": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-view.webp", "thumbnail_image": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-thumb.webp", "video_url": null, "video_poster_url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-view.webp", "type": "product", "commerce_mode": "shop", "currency": "NGN", "price": 28500, "discount_price": 24225, "compare_at_price": 28500, "is_price_from": false, "price_range": { "min": 28500, "max": 28500 }, "has_variants": true, "has_addons": false, "tax_inclusive": false, "discount": { "id": "019b0c4d-5e6f-7a8b-9c0d-1e2f3a4b5c31", "title": "Lagos Fashion Week 15% Off", "type": "percentage", "value": 15, "amount": 4275, "final_price": 24225, "image_url": "https://media.usequeek.com/uploads/stores/2207/discounts/fashion-week.jpg" }, "discounts": [ { "id": "019b0c4d-5e6f-7a8b-9c0d-1e2f3a4b5c31", "title": "Lagos Fashion Week 15% Off", "type": "percentage", "value": 15, "amount": 4275, "final_price": 24225, "image_url": "https://media.usequeek.com/uploads/stores/2207/discounts/fashion-week.jpg" } ], "media": { "thumbnail": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-thumb.webp", "image": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-view.webp", "original": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress.jpg", "primary_variant_image": null, "image_variants": { "thumb": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-thumb.webp", "w": null, "h": null }, "card": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-card.webp", "w": 480, "h": 600 }, "card2x": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-card2x.webp", "w": 800, "h": 1000 }, "view": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-view.webp", "w": 1200, "h": 1500 }, "wa": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-wa.jpg", "w": 1080, "h": 1350 }, "original": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress.jpg", "w": 1200, "h": 1500 } }, "primary_variant_image_variants": null, "images": [ { "id": 77101, "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-card.webp", "alt": "Ankara midi dress on a mannequin", "variants": { "thumb": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-thumb.webp", "w": null, "h": null }, "card": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-card.webp", "w": 480, "h": 600 }, "card2x": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-card2x.webp", "w": 800, "h": 1000 }, "view": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-view.webp", "w": 1200, "h": 1500 }, "wa": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-wa.jpg", "w": 1080, "h": 1350 }, "original": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress.jpg", "w": 1200, "h": 1500 } } }, { "id": 77103, "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back-card.webp", "alt": "Ankara midi dress, back view", "variants": { "thumb": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back-thumb.webp", "w": null, "h": null }, "card": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back-card.webp", "w": 480, "h": 600 }, "card2x": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back-card2x.webp", "w": 800, "h": 1000 }, "view": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back-view.webp", "w": 1200, "h": 1500 }, "wa": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back-wa.jpg", "w": 1080, "h": 1350 }, "original": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back.jpg", "w": 1200, "h": 1500 } } } ], "video_url": null, "video_poster_url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-view.webp" }, "inventory": { "in_stock": true, "tracking": true, "quantity": 18, "allow_backorder": false, "low_stock_threshold": 5, "updated_at": "2026-09-22 16:05:00" }, "variant_summary": { "count": 3, "min_price": 28500, "max_price": 28500, "total_stock": 18, "tracks_inventory": true, "in_stock": true }, "variants_count": 3, "rating": 4.8, "review_count": 14, "flags": { "featured": false, "is_marketplace": false, "is_wholesale": false, "is_new": false }, "metafields": {}, "created_at": "2026-06-18 09:40:00", "updated_at": "2026-09-22 16:05:00", "shop": { "id": "019b0c4d-5e6f-7a8b-9c0d-1e2f3a4b5c01", "name": "Zuri Atelier", "slug": "zuri-atelier", "logo": "https://media.usequeek.com/uploads/stores/2207/logo.png", "rating": 4.7, "rating_count": 486 }, "addons": [], "taxonomy": { "categories": [ { "id": "019b0c4d-5e6f-7a8b-9c0d-1e2f3a4b5c21", "name": "Dresses", "slug": "dresses" } ], "tags": [], "brand": null, "collections": [ { "id": "019b0c4d-5e6f-7a8b-9c0d-1e2f3a4b5c25", "name": "New Season", "slug": "new-season", "mode": "manual" } ] }, "purchase_limits": { "min_qty": 1, "max_qty": null, "step_qty": 1 }, "measurement": { "weight": { "value": 0.5, "unit": "kg" }, "dimensions": null }, "specs": [], "options": [ { "name": "Size", "type": "size", "values": [ "S", "M", "L" ], "values_detailed": [ { "value": "S", "color_code": null, "image": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress.jpg" }, { "value": "M", "color_code": null, "image": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress.jpg" }, { "value": "L", "color_code": null, "image": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress.jpg" } ] } ], "variants": [ { "id": "019b0c4d-5f10-7a02-8c61-0b2d4e6f8a01", "sku": "ZRA-AMD-S", "title": "S", "option_values": { "Size": "S" }, "price": 28500, "discount_price": 24225, "discount_amount": 4275, "has_discount": true, "compare_at_price": null, "stock": 6, "track_inventory": true, "is_active": true, "in_stock": true, "weight": 0.4, "position": 0, "media": { "thumbnail": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress.jpg", "image": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress.jpg", "image_media_id": null, "image_variants": { "thumb": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-thumb.webp", "w": null, "h": null }, "card": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-card.webp", "w": 480, "h": 600 }, "card2x": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-card2x.webp", "w": 800, "h": 1000 }, "view": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-view.webp", "w": 1200, "h": 1500 }, "wa": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-wa.jpg", "w": 1080, "h": 1350 }, "original": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress.jpg", "w": 1200, "h": 1500 } }, "images": [ { "id": 77101, "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-card.webp", "alt": "Ankara midi dress on a mannequin", "variants": { "thumb": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-thumb.webp", "w": null, "h": null }, "card": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-card.webp", "w": 480, "h": 600 }, "card2x": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-card2x.webp", "w": 800, "h": 1000 }, "view": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-view.webp", "w": 1200, "h": 1500 }, "wa": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-wa.jpg", "w": 1080, "h": 1350 }, "original": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress.jpg", "w": 1200, "h": 1500 } } }, { "id": 77103, "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back-card.webp", "alt": "Ankara midi dress, back view", "variants": { "thumb": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back-thumb.webp", "w": null, "h": null }, "card": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back-card.webp", "w": 480, "h": 600 }, "card2x": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back-card2x.webp", "w": 800, "h": 1000 }, "view": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back-view.webp", "w": 1200, "h": 1500 }, "wa": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back-wa.jpg", "w": 1080, "h": 1350 }, "original": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back.jpg", "w": 1200, "h": 1500 } } } ], "video_url": null, "source": "product" } }, { "id": "019b0c4d-5f10-7a02-8c61-0b2d4e6f8a02", "sku": "ZRA-AMD-M", "title": "M", "option_values": { "Size": "M" }, "price": 28500, "discount_price": 24225, "discount_amount": 4275, "has_discount": true, "compare_at_price": null, "stock": 8, "track_inventory": true, "is_active": true, "in_stock": true, "weight": 0.45, "position": 1, "media": { "thumbnail": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress.jpg", "image": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress.jpg", "image_media_id": null, "image_variants": { "thumb": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-thumb.webp", "w": null, "h": null }, "card": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-card.webp", "w": 480, "h": 600 }, "card2x": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-card2x.webp", "w": 800, "h": 1000 }, "view": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-view.webp", "w": 1200, "h": 1500 }, "wa": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-wa.jpg", "w": 1080, "h": 1350 }, "original": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress.jpg", "w": 1200, "h": 1500 } }, "images": [ { "id": 77101, "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-card.webp", "alt": "Ankara midi dress on a mannequin", "variants": { "thumb": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-thumb.webp", "w": null, "h": null }, "card": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-card.webp", "w": 480, "h": 600 }, "card2x": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-card2x.webp", "w": 800, "h": 1000 }, "view": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-view.webp", "w": 1200, "h": 1500 }, "wa": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-wa.jpg", "w": 1080, "h": 1350 }, "original": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress.jpg", "w": 1200, "h": 1500 } } }, { "id": 77103, "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back-card.webp", "alt": "Ankara midi dress, back view", "variants": { "thumb": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back-thumb.webp", "w": null, "h": null }, "card": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back-card.webp", "w": 480, "h": 600 }, "card2x": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back-card2x.webp", "w": 800, "h": 1000 }, "view": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back-view.webp", "w": 1200, "h": 1500 }, "wa": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back-wa.jpg", "w": 1080, "h": 1350 }, "original": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back.jpg", "w": 1200, "h": 1500 } } } ], "video_url": null, "source": "product" } }, { "id": "019b0c4d-5f10-7a02-8c61-0b2d4e6f8a03", "sku": "ZRA-AMD-L", "title": "L", "option_values": { "Size": "L" }, "price": 28500, "discount_price": 24225, "discount_amount": 4275, "has_discount": true, "compare_at_price": null, "stock": 4, "track_inventory": true, "is_active": true, "in_stock": true, "weight": 0.5, "position": 2, "media": { "thumbnail": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress.jpg", "image": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress.jpg", "image_media_id": null, "image_variants": { "thumb": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-thumb.webp", "w": null, "h": null }, "card": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-card.webp", "w": 480, "h": 600 }, "card2x": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-card2x.webp", "w": 800, "h": 1000 }, "view": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-view.webp", "w": 1200, "h": 1500 }, "wa": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-wa.jpg", "w": 1080, "h": 1350 }, "original": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress.jpg", "w": 1200, "h": 1500 } }, "images": [ { "id": 77101, "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-card.webp", "alt": "Ankara midi dress on a mannequin", "variants": { "thumb": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-thumb.webp", "w": null, "h": null }, "card": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-card.webp", "w": 480, "h": 600 }, "card2x": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-card2x.webp", "w": 800, "h": 1000 }, "view": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-view.webp", "w": 1200, "h": 1500 }, "wa": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-wa.jpg", "w": 1080, "h": 1350 }, "original": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress.jpg", "w": 1200, "h": 1500 } } }, { "id": 77103, "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back-card.webp", "alt": "Ankara midi dress, back view", "variants": { "thumb": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back-thumb.webp", "w": null, "h": null }, "card": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back-card.webp", "w": 480, "h": 600 }, "card2x": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back-card2x.webp", "w": 800, "h": 1000 }, "view": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back-view.webp", "w": 1200, "h": 1500 }, "wa": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back-wa.jpg", "w": 1080, "h": 1350 }, "original": { "url": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress-back.jpg", "w": 1200, "h": 1500 } } } ], "video_url": null, "source": "product" } } ], "fulfillment": { "type": "delivery_or_pickup", "is_digital": false, "delivery_available": true, "pickup_available": true, "lead_time_min": null, "lead_time_max": null }, "compliance": { "warranty_months": 0, "country_of_origin": null, "safety_notes": null }, "seo": { "meta_title": null, "meta_description": null, "canonical_url": null, "keywords": [] }, "analytics": { "sales_count": 31, "view_count": 218, "favorite_count": 0, "review_count": 14 } }, "variant": { "id": "019b0c4d-5f10-7a02-8c61-0b2d4e6f8a02", "p_id": 44102, "title": "M", "option_values": { "Size": "M" } } }}Removes this customer’s saved product-only row or the specified variant row. The store’s merchant, and apps holding merchant-customers-detail, can read saved items.
Authorization
clientKey customerToken X-Client-Key<token>
The store's API key (Dashboard → Settings → API keys). pk_live_… public keys are for browser code and only work from an origin on the key's allowlist; sk_live_… private keys are for servers and native apps and need no Origin.
In: header
AuthorizationBearer <token>
The customer access credential from any sign-in session answer (access_token). Account operations only — send as Authorization: Bearer <access_token> ALONGSIDE X-Client-Key. It is bound to one store: a credential issued for another vendor answers 403 here.
In: header
Path Parameters
ref*string
Query Parameters
variant?|
Length
1 <= length <= 255Header Parameters
X-Client-Key*string
Your store API key (Dashboard → Settings → API keys). pk_live_… public keys are for browser code and only work from an origin on the key's allowlist; sk_live_… private keys are for servers and native apps and need no Origin.
X-Request-Id?string
Your own correlation id (8–128 chars, ^[A-Za-z0-9_.:-]+$). Echoed back on the response and on every log line of the request; one is generated when you omit it.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X DELETE "https://example.com/store/wishlist-items/ankara-midi-dress?variant=44102" \ -H "X-Client-Key: {{clientKey}}"{ "status": "success", "message": "Wishlist removal processed", "data": { "removed": false }}