Fetch purchase order detail
GET/v1/entities/:entity_id/purchase_orders/:uuid
Retrieves one purchase order by uuid, in any status, addressed and shaped exactly like the list endpoint.
Accepts the same fields[...] and include=line_items,receipts,supplier parameters.
Requires the purchase_orders:read scope. The key's shop must also be linked to
{entity_id}, else 403 — see the API key scheme on the Authentication page.
include=receipts additionally requires the purchase_order_receipts:read scope; without it
the request returns 403. Included receipts are narrowed to committed status only.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 504
Returns a purchase order.
Unsupported or malformed fields or include param.
The Authorization header is missing, is not HTTP Basic, or does not carry a valid API key. Manage your keys under Shopify admin → Bookkeep app → Settings → Manage API Keys.
Missing required scope, the key's shop does not match, or the key's shop is not linked to {entity_id}.
No purchase order with that uuid for this shop (also returned for a soft-deleted purchase order). A malformed path segment — an {entity_id} containing anything other than letters and digits, or a {uuid} containing anything other than letters, digits, - or _ — is instead rejected by routing before this endpoint runs, and that 404 carries the Bookkeep app's HTML error page rather than the JSON body below.
The purchase order service did not respond in time. Retry with backoff.