Get ShipHero Purchase Order
GET/api/shiphero/integration-instances/:integration_instance/purchase-orders/:purchaseOrder
Get one ShipHero purchase order SKU.io created, held back or linked, with everything about it: the SKU.io source (source: purchase order or warehouse transfer, its supplier and warehouse, or deleted: true when the order is gone), the ShipHero vendor and the SKU.io supplier it is mapped to, the ShipHero warehouse it went to and the SKU.io warehouse it was sent for, the 3PL customer account it was filed under, the header as sent (tracking_number, po_date, po_date_source, notes, backup_emailed_at), and the hold or last error.
integrations:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
lines: one per ShipHero SKU — the quantity SKU.io sent, shiphero_quantity (from the last full read of the PO from ShipHero; null before one), received, rejected and sell-ahead, the SKU.io order lines it combines, and flags: quantity_differs (ShipHero's quantity isn't what was sent), over_received, no_product (no SKU.io product) and not_in_shiphero (ShipHero no longer has the line). remote_only_lines lists SKUs ShipHero has on the PO that SKU.io never sent; mismatch_count counts flagged lines.
related: the other ShipHero purchase orders of the same SKU.io order (primary, supplementary -A, revisions -R2, replaced). receipts: the SKU.io receipts posted from this PO's ShipHero receiving, newest first. json_object: the purchase order as last read from ShipHero.
shiphero_url is the outside link set by asn.portal_po_url_template, and null when the connection doesn't link outside SKU.io (the default).
Returns 404 when the purchase order belongs to another connection.
Requires permission: integrations.show
Authentication: Requires Bearer token.
Request
Responses
- 200
- 401
- 403
- 404
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Not Found
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.