vendorOrders_getPurchaseOrder
Get full details for a single vendor purchase order.
readAmazon Seller (SP-API)sp.vendorOrders
Amazon SP-API · getPurchaseOrder · GET /vendor/orders/v1/purchaseOrders/{purchaseOrderNumber}
Call it
In an AI client (MCP)
{
"name": "vendorOrders_getPurchaseOrder",
"arguments": {
"store": "myStore-US",
"purchase_order_number": "<purchase_order_number>"
}
}From code (Tool API)
curl -X POST https://api.sellersheetai.com/api/v1/tools/vendorOrders_getPurchaseOrder \
-H "Authorization: Bearer $SELLERSHEET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"store":"myStore-US","purchase_order_number":"<purchase_order_number>"}'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. |
purchase_order_numberrequired | string | 8-character alpha-numeric PO number. |
Result
Every tool answers {notification, data, human_action}; data carries:
data.order— the PO — purchaseOrderState, orderDetails.items[] {itemSequenceNumber, amazonProductIdentifier, vendorProductIdentifier, orderedQuantity, netCost, isBackOrderAllowed}, orderDetails.shipToParty and deliveryWindow; an acknowledgement echoes these item fields.data.purchaseOrderNumber— the PO number echoed back.
Workflow
- 1. Call with the purchaseOrderNumber from vendorOrders_getPurchaseOrders. 2. Review data.order for item quantities, delivery windows, and ship-to location. 3. Call vendorOrders_submitAcknowledgement with accepted/rejected items.