# vendorOrders_getPurchaseOrder (https://sellersheetai.com/docs/mcp-api/tools/vendorOrders_getPurchaseOrder)

> Get full details for a single vendor purchase order.

Access: **READ** · toolset amazon_sp · family sp.vendorOrders

Amazon SP-API · getPurchaseOrder · GET /vendor/orders/v1/purchaseOrders/{purchaseOrderNumber}

## Call it

MCP tool call:

```json
{
  "name": "vendorOrders_getPurchaseOrder",
  "arguments": {
    "store": "myStore-US",
    "purchase_order_number": "<purchase_order_number>"
  }
}
```

Tool API (early access — contact us):

```bash
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>"}'
```

## Arguments

| Name | Type | Required | Description |
|---|---|---|---|
| `store` | string | yes | the store ref `<store>-<CC>` (name-country, e.g. 'myStore-US') — one of get_user_context's store_refs, verbatim. |
| `purchase_order_number` | string | yes | 8-character alpha-numeric PO number. |

## Result

- `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.