vendorOrders_getPurchaseOrdersStatus
Get purchase order status list.
readAmazon Seller (SP-API)sp.vendorOrders
Date range must not exceed 7 days. Amazon SP-API · getPurchaseOrdersStatus · GET /vendor/orders/v1/purchaseOrdersStatus Useful for monitoring whether Amazon has received and accepted acknowledgements, or to check delivery/receipt status of fulfilment.
Call it
In an AI client (MCP)
{
"name": "vendorOrders_getPurchaseOrdersStatus",
"arguments": {
"store": "myStore-US"
}
}From code (Tool API)
curl -X POST https://api.sellersheetai.com/api/v1/tools/vendorOrders_getPurchaseOrdersStatus \
-H "Authorization: Bearer $SELLERSHEET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"store":"myStore-US"}'Early access — the Tool API is open on request, contact us.
Arguments
| Name | Type | Description |
|---|---|---|
storerequired | string | the store ref `<store>-<CC>` (name-country, e.g. 'myStore-US') — one of get_user_context's store_refs, verbatim. |
created_after | string · date-time | ISO 8601 bounds on when the PO became available (window ≤ 7 days). |
created_before | string · date-time | ISO 8601 bounds on when the PO became available (window ≤ 7 days). |
updated_after | string · date-time | ISO 8601 — POs updated after this. |
updated_before | string · date-time | ISO 8601 — POs updated before this. |
purchase_order_number | string | Filter to a single PO number. |
purchase_order_status | string | keeps only POs in this status. Allowed: OPEN | CLOSED.OPENCLOSED |
item_confirmation_status | string | keeps only POs with items in this confirmation state. Allowed: ACCEPTED | PARTIALLY_ACCEPTED | REJECTED | UNCONFIRMED.ACCEPTEDPARTIALLY_ACCEPTEDREJECTEDUNCONFIRMED |
item_receive_status | string | keeps only POs with items in this receive state. Allowed: NOT_RECEIVED | PARTIALLY_RECEIVED | RECEIVED.NOT_RECEIVEDPARTIALLY_RECEIVEDRECEIVED |
ordering_vendor_code | string | Filter by vendor code. |
ship_to_party_id | string | Filter by fulfilment centre ID. |
limit | integer · 1–100 | Max records returned, 1–100 (Amazon default 100). |
sort_order | string | ASC or DESC.ASCDESC |
next_token | string | the cursor from the previous call's data.nextToken; omit for the first page. |
Result
Every tool answers {notification, data, human_action}; data carries:
data.ordersStatus— list of PO status dicts.data.count— number of statuses returned.data.nextToken— pass to next call if present.
Workflow
- 1. Call with updated_after/updated_before to find recently changed POs. 2. Narrow with purchase_order_status, item_confirmation_status or item_receive_status. 3. While data.nextToken is present, call again with it as next_token.