Supplier orders, newest first
- Credentials, one of
- Station token
- OAuth access token
- Scopes
listings:read
Status, lines and what has arrived.
Access: OAuth scope listings:read; not write-gated.
Paged: { items, nextCursor }, limit (default 30, at most 100) and an opaque cursor. It pages through the newest 100.
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.
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 30, at most 100 (more is 100; a missing or unusable value is 30).
1 <= value <= 10030OK
application/json- response
data*curl -X GET 'https://api.shopeazy.co/v1/merchant/stores/<storeId>/purchase-orders' \ -H 'Authorization: Bearer <access_token>'{ "data": { "items": [], "nextCursor": null }}Retire a supplier DELETE
Archives it: it stops being offered for new orders, and old purchase orders stay readable because they hold the name anyway. Retiring one that is already archived answers the same way, so a retry is safe. `updateSupplier` with `status: active` brings it back. Access: OAuth scope `listings:write`; write-gated by the subscription.
Draft an order to a supplier POST
For materials (`materialId`) or stock the shop buys in (`listingId`). Scale. It starts as a draft: mark it sent with the status operation. Plan: Scale (403 `plan_limit` on a plan without it). Reading and changing what already exists stays open after a downgrade. Access: OAuth scope `listings:write`; write-gated by the subscription.