Skip to main content

Get Sales Order Details

GET 
/api/sales-orders/:salesOrder

Returns the complete order graph for a single sales order: header fields, line items with inventory and cost-of-goods breakdowns, fulfillments (with shipment lines and tracking), payments, notes, financial lines, discounts, addresses, linked purchase orders, and backorder coverage dates.

Required scope: orders:read

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

This is the full detail endpoint. For a lighter order summary, use GET /api/v2/sales-orders/{id} instead.

Authentication: Requires Bearer token.

Response notes:

  • item_info contains the order lines, each with allocation/fulfillment quantities, product info, warehouse, per-warehouse inventory, and a cogs object aggregating the inventory cost layers consumed by the line.
  • fulfillment contains the order's shipments, each with its shipment lines, tracking, warehouse, and provider sync timestamps.
  • sales_order_shipping_address / sales_order_billing_address are the order's own address snapshots (they survive later edits to the underlying address records).
  • customer_name, customer_email, customer_company, customer_phone render the order's buyer snapshot; channel orders without a stored customer record still populate these.
  • Monetary totals (total, product_total, tax_total, discount_total, etc.) are in the order currency.

Path parameters:

  • salesOrder (required): Sales order ID.

Request​

Responses​

OK

Response Headers
    Content-Type