List or search the catalogue
- Credentials, one of
- Station token
- OAuth access token
- Scopes
listings:read
Access: OAuth scope listings:read; not write-gated.
Paged: { items, nextCursor }, limit (default 100, at most 200) and an opaque cursor.
AuthorizationBearer <token>It may call only the operations whose x-stations lists its kind, on its own store, and acts through the access of the owner or admin who paired it. Unpairing it, or that person leaving the business, ends it (401 station_revoked).
storeId*stringA store the person can reach. Any other id answers 404, never 403.
kind?string"physical""service""ticketing""tour"status?stringDefault all.
"draft""active""archived""all"search?stringlowStock?booleanOnly items at or under their low-stock level.
hasPhoto?booleantrue: only items with at least one photo (what a product shoot can start from). Default: every item.
cursor?stringThe nextCursor of the previous page, unchanged. A cursor that is not one we gave you is 400 bad_request.
limit?integerPage size: default 100, at most 200 (more is 200; a missing or unusable value is 100).
1 <= value <= 200100OK
application/json- response
data*curl -X GET 'https://api.shopeazy.co/v1/merchant/stores/<storeId>/products' \ -H 'Authorization: Bearer <access_token>'{ "data": { "items": [ { "id": "Vbysrj7cZDLaTk20BVsd", "kitId": "5gvu5rElbDNOBru2HYMi", "title": "Botanical garden walk", "slug": "botanical-garden-walk", "kind": "tour", "price": { "amount": 35000, "currency": "ZAR" }, "imageUrl": null, "active": true, "stock": null }, { "id": "Lt4HUbN7ScpvnxPHUARR", "kitId": "cbzXdyoC08TecFtCKeTn", "title": "Glazed ceramic pot", "slug": "glazed-ceramic-pot", "kind": "physical", "price": { "amount": 18900, "currency": "ZAR" }, "imageUrl": "https://images.example.com/plants/ceramic-pot.jpg", "active": true, "stock": 20 }, { "id": "65myAK8IFZKwZBG84Gmw", "kitId": "cbzXdyoC08TecFtCKeTn", "title": "Monstera deliciosa, 20 cm pot", "slug": "monstera-deliciosa-20-cm-pot", "kind": "physical", "price": { "amount": 34900, "currency": "ZAR" }, "imageUrl": "https://images.example.com/plants/monstera.jpg", "active": true, "stock": 24 } ], "nextCursor": null }}