GET/v1/tenants/{tenantId}/ecom_stores/{eComStoreId}/orders/{orderId}
Get sales order
Retrieves details of a specific sales order by ID or order number, including line items, captures, receipts, refunds, shipments, and vouchers
Parameters
tenantIdrequiredeComStoreIdrequiredorderIdrequiredThe ID or order number of the sales order to retrieve
Responses
application/jsoncapturesrequiredShow item fields
amountoptionalCaptured amount
- Format: BigDecimal
- Pattern: ^-?\d+(\.\d{1,2})?$
Example"747.50"createdDateoptionalDate the capture was created
- Format: date
Example"2024-06-15"idrequired- Example
"01234567-89ab-cdef-0123-456789abcdef" linesrequiredShow item fields
lineItemIdrequiredReference to order line item
Example"01234567-89ab-cdef-0123-456789abcdef"quantityrequiredQuantity captured
- Format: BigDecimal
Example"2.0"
statusrequiredCapture status
Allowed values"PENDING""CONFIRMED""FAILED"
currencyIsoCoderequiredISO 4217 currency code
Example"NOK"customerIdrequiredCustomer ID associated with the order
Example"01234567-89ab-cdef-0123-456789abcdef"deliveryAddressrequiredShow child fields
cityrequired- Example
"Oslo" countryIsoCoderequiredISO 3166-1 alpha-2 country code
Example"NO"emailoptional- Example
"ola.nordmann@example.com" namerequiredRecipient name
Example"Ola Nordmann"phoneoptional- Example
"+4790123456" postCoderequired- Example
"0123" streetrequiredStreet address including house number
Example"Storgata 1"
externalOrderIdoptionalExternal order ID from your e-commerce platform
Example"SHOP-123"externalOrderNumberoptionalExternal order number displayed to customer
Example"WEB-2024-00123"freightoptionalShow child fields
carrierAgreementCoderequired- Example
"6838716034162098000" carrierCoderequired- Example
"porterbuddy" carrierNameoptional- Example
"Porterbuddy" carrierProductCoderequired- Example
"8747679326213767168" carrierProductNameoptional- Example
"Evening delivery" carrierProductPayloadoptionalProvider-specific extra data
Show child fields
partnerNameoptionalPartner name from provider
partnerNumberoptionalPartner number from provider
freightVatRateoptionalVAT rate for freight as a percentage
- Format: BigDecimal
- Pattern: ^-?\d+(\.\d{1,2})?$
Example"25.00"netFreightAmountoptionalNet freight/shipping cost amount (excl. VAT)
- Format: BigDecimal
- Pattern: ^-?\d+(\.\d{1,2})?$
Example"49.00"
idrequired- Example
"01234567-89ab-cdef-0123-456789abcdef" invoiceAddressrequiredShow child fields
cityrequired- Example
"Oslo" countryIsoCoderequiredISO 3166-1 alpha-2 country code
Example"NO"emailrequiredEmail for invoice delivery
Example"ola.nordmann@example.com"namerequiredRecipient name
Example"Ola Nordmann"postCoderequired- Example
"0123" streetrequiredStreet address including house number
Example"Storgata 1"
lineItemsrequiredShow item fields
barcodeoptionalBarcode (EAN/GTIN)
Example"1234567890123"cancelledQuantityoptionalQuantity cancelled after line closure; null while the line is open or fully shipped
- Format: BigDecimal
Example"1.0"discountrequiredDiscount percentage applied to this line
- Format: BigDecimal
- Pattern: ^-?\d+(\.\d{1,2})?$
Example"0.00"estimatedDeliveryDaterequired- Format: date
Example"2024-06-20"fulfilledQuantityrequiredQuantity fulfilled/shipped for this line
- Format: BigDecimal
Example"2.0"grossAmountrequiredGross amount including VAT
- Format: BigDecimal
- Pattern: ^-?\d+(\.\d{1,2})?$
Example"747.50"idrequired- Example
"01234567-89ab-cdef-0123-456789abcdef" netAmountrequiredNet amount excluding VAT (quantity × netUnitPrice)
- Format: BigDecimal
- Pattern: ^-?\d+(\.\d{1,2})?$
Example"598.00"netUnitOrderDiscountAmountrequiredNet unit order discount amount applied to this line
- Format: BigDecimal
- Pattern: ^-?\d+(\.\d{1,2})?$
Example"10.00"netUnitPricerequiredNet unit price excluding VAT
- Format: BigDecimal
- Pattern: ^-?\d+(\.\d{1,2})?$
Example"299.00"productNamerequired- Example
"Classic T-Shirt Black Medium" quantityrequiredQuantity ordered
- Format: BigDecimal
Example"2.0"returnTicketBarcodeUrloptionalURL to a Code128 barcode SVG image for this line's exchange label. The last path segment is the base64url encoding of the scannable barcode value "SO <order number> <line position>", which is what the barcode encodes, not the return ticket number above
Example"/v1/tenants/{tenantId}/ecom_stores/{eComStoreId}/barcodes/code128/U08gV0VCNDAwOTkwMyAy"returnTicketNumberrequiredHuman readable return ticket number (exchange label code) for this line, the order number followed by the line position
Example"WEB40099032"skuIdrequiredSKU ID of the product
Example"01234567-89ab-cdef-0123-456789abcdef"skuNumberrequired- Example
"PROD-BLK-M" vatAmountrequiredVAT amount
- Format: BigDecimal
- Pattern: ^-?\d+(\.\d{1,2})?$
Example"149.50"vatRaterequiredVAT rate as percentage
- Format: BigDecimal
- Pattern: ^-?\d+(\.\d{1,2})?$
Example"25.00"
orderDaterequiredDate the order was placed
- Format: date
Example"2024-06-15"orderNumberrequiredHuman-readable order number
Example"SO-2024-00123"orderStatusrequiredCurrent status of the order
Allowed values"PLANNED""CLOSED""RELEASED"receiptsrequiredShow item fields
createdDaterequiredDate the receipt was created
- Format: date
Example"2024-06-15"grossAmountrequiredGross amount including VAT
- Format: BigDecimal
- Pattern: ^-?\d+(\.\d{1,2})?$
Example"747.50"idrequired- Example
"01234567-89ab-cdef-0123-456789abcdef" linesrequiredShow item fields
fulfilledQuantityrequiredQuantity fulfilled/picked
- Format: BigDecimal
Example"2.0"lineItemIdrequiredReference to order line item
Example"01234567-89ab-cdef-0123-456789abcdef"quantityrequiredQuantity invoiced
- Format: BigDecimal
Example"2.0"
netAmountrequiredNet amount excluding VAT
- Format: BigDecimal
- Pattern: ^-?\d+(\.\d{1,2})?$
Example"598.00"
refundsrequiredShow item fields
createdDaterequiredDate the refund was created
- Format: date
Example"2024-06-20"grossAmountrequiredGross refund amount including VAT
- Format: BigDecimal
- Pattern: ^-?\d+(\.\d{1,2})?$
Example"747.50"grossReturnFeeAmountrequiredGross return fee amount including VAT
- Format: BigDecimal
- Pattern: ^-?\d+(\.\d{1,2})?$
Example"59.00"idrequired- Example
"01234567-89ab-cdef-0123-456789abcdef" linesrequiredShow item fields
lineItemIdrequiredReference to order line item
Example"01234567-89ab-cdef-0123-456789abcdef"quantityrequiredQuantity refunded
- Format: BigDecimal
Example"1.0"
netAmountrequiredNet refund amount excluding VAT
- Format: BigDecimal
- Pattern: ^-?\d+(\.\d{1,2})?$
Example"598.00"netReturnFeeAmountrequiredNet return fee amount excluding VAT
- Format: BigDecimal
- Pattern: ^-?\d+(\.\d{1,2})?$
Example"47.20"statusrequiredRefund status
Allowed values"OPEN""CLOSED"
shipmentsrequiredShow item fields
captureIdrequiredReference to the capture (picking list) this shipment originated from
Example"01234567-89ab-cdef-0123-456789abcdef"createdDateoptionalDate the shipment was created
- Format: date
Example"2024-06-16"idrequired- Example
"01234567-89ab-cdef-0123-456789abcdef" linesrequiredShow item fields
lineItemIdrequiredReference to order line item
Example"01234567-89ab-cdef-0123-456789abcdef"quantityrequiredQuantity shipped
- Format: BigDecimal
Example"2.0"
trackingNumberoptional- Example
"1Z999AA10123456784" trackingUrloptional- Example
"https://track.example.com/1Z999AA10123456784"
updatedAtrequired- Format: ISO 8681 timestamp
Example"2025-10-28T12:37:42Z"vouchersrequiredShow item fields
externalReferencerequiredExternal reference for the voucher
Example"abc123-promo-uuid"titleoptionalDisplay name for the voucher
Example"Summer Sale 20%"typeoptional- Example
"PERCENTAGE" valueoptional- Format: BigDecimal
Example"20.00"
401Unauthorized - Invalid or missing authentication
Unauthorized - Invalid or missing authentication
application/jsonerrorrequiredStable error code
Example"INVALID_REQUEST"messagerequiredHuman-readable error message
Example"Invalid customer ID format"resolutionrequiredSuggested next action
Example"Correct the customer ID and retry the request"
403
application/jsonerrorrequiredStable error code
Example"INVALID_REQUEST"messagerequiredHuman-readable error message
Example"Invalid customer ID format"resolutionrequiredSuggested next action
Example"Correct the customer ID and retry the request"
404Not Found - Order not found or does not belong to this ecom store
Not Found - Order not found or does not belong to this ecom store
application/jsonerrorrequiredStable error code
Example"INVALID_REQUEST"messagerequiredHuman-readable error message
Example"Invalid customer ID format"resolutionrequiredSuggested next action
Example"Correct the customer ID and retry the request"
500
application/jsonerrorrequiredStable error code
Example"INVALID_REQUEST"messagerequiredHuman-readable error message
Example"Invalid customer ID format"resolutionrequiredSuggested next action
Example"Correct the customer ID and retry the request"