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

tenantIdrequired
eComStoreIdrequired
orderIdrequired

The ID or order number of the sales order to retrieve

Responses

200Response
application/json
capturesrequired
Show item fields
amountoptional

Captured amount

  • Format: BigDecimal
  • Pattern: ^-?\d+(\.\d{1,2})?$
Example"747.50"
createdDateoptional

Date the capture was created

  • Format: date
Example"2024-06-15"
idrequired
Example"01234567-89ab-cdef-0123-456789abcdef"
linesrequired
Show item fields
lineItemIdrequired

Reference to order line item

Example"01234567-89ab-cdef-0123-456789abcdef"
quantityrequired

Quantity captured

  • Format: BigDecimal
Example"2.0"
statusrequired

Capture status

Allowed values"PENDING""CONFIRMED""FAILED"
currencyIsoCoderequired

ISO 4217 currency code

Example"NOK"
customerIdrequired

Customer ID associated with the order

Example"01234567-89ab-cdef-0123-456789abcdef"
deliveryAddressrequired
Show child fields
cityrequired
Example"Oslo"
countryIsoCoderequired

ISO 3166-1 alpha-2 country code

Example"NO"
emailoptional
Example"ola.nordmann@example.com"
namerequired

Recipient name

Example"Ola Nordmann"
phoneoptional
Example"+4790123456"
postCoderequired
Example"0123"
streetrequired

Street address including house number

Example"Storgata 1"
externalOrderIdoptional

External order ID from your e-commerce platform

Example"SHOP-123"
externalOrderNumberoptional

External order number displayed to customer

Example"WEB-2024-00123"
freightoptional
Show child fields
carrierAgreementCoderequired
Example"6838716034162098000"
carrierCoderequired
Example"porterbuddy"
carrierNameoptional
Example"Porterbuddy"
carrierProductCoderequired
Example"8747679326213767168"
carrierProductNameoptional
Example"Evening delivery"
carrierProductPayloadoptional

Provider-specific extra data

Show child fields
partnerNameoptional

Partner name from provider

partnerNumberoptional

Partner number from provider

freightVatRateoptional

VAT rate for freight as a percentage

  • Format: BigDecimal
  • Pattern: ^-?\d+(\.\d{1,2})?$
Example"25.00"
netFreightAmountoptional

Net freight/shipping cost amount (excl. VAT)

  • Format: BigDecimal
  • Pattern: ^-?\d+(\.\d{1,2})?$
Example"49.00"
idrequired
Example"01234567-89ab-cdef-0123-456789abcdef"
invoiceAddressrequired
Show child fields
cityrequired
Example"Oslo"
countryIsoCoderequired

ISO 3166-1 alpha-2 country code

Example"NO"
emailrequired

Email for invoice delivery

Example"ola.nordmann@example.com"
namerequired

Recipient name

Example"Ola Nordmann"
postCoderequired
Example"0123"
streetrequired

Street address including house number

Example"Storgata 1"
lineItemsrequired
Show item fields
barcodeoptional

Barcode (EAN/GTIN)

Example"1234567890123"
cancelledQuantityoptional

Quantity cancelled after line closure; null while the line is open or fully shipped

  • Format: BigDecimal
Example"1.0"
discountrequired

Discount percentage applied to this line

  • Format: BigDecimal
  • Pattern: ^-?\d+(\.\d{1,2})?$
Example"0.00"
estimatedDeliveryDaterequired
  • Format: date
Example"2024-06-20"
fulfilledQuantityrequired

Quantity fulfilled/shipped for this line

  • Format: BigDecimal
Example"2.0"
grossAmountrequired

Gross amount including VAT

  • Format: BigDecimal
  • Pattern: ^-?\d+(\.\d{1,2})?$
Example"747.50"
idrequired
Example"01234567-89ab-cdef-0123-456789abcdef"
netAmountrequired

Net amount excluding VAT (quantity × netUnitPrice)

  • Format: BigDecimal
  • Pattern: ^-?\d+(\.\d{1,2})?$
Example"598.00"
netUnitOrderDiscountAmountrequired

Net unit order discount amount applied to this line

  • Format: BigDecimal
  • Pattern: ^-?\d+(\.\d{1,2})?$
Example"10.00"
netUnitPricerequired

Net unit price excluding VAT

  • Format: BigDecimal
  • Pattern: ^-?\d+(\.\d{1,2})?$
Example"299.00"
productNamerequired
Example"Classic T-Shirt Black Medium"
quantityrequired

Quantity ordered

  • Format: BigDecimal
Example"2.0"
returnTicketBarcodeUrloptional

URL 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"
returnTicketNumberrequired

Human readable return ticket number (exchange label code) for this line, the order number followed by the line position

Example"WEB40099032"
skuIdrequired

SKU ID of the product

Example"01234567-89ab-cdef-0123-456789abcdef"
skuNumberrequired
Example"PROD-BLK-M"
vatAmountrequired

VAT amount

  • Format: BigDecimal
  • Pattern: ^-?\d+(\.\d{1,2})?$
Example"149.50"
vatRaterequired

VAT rate as percentage

  • Format: BigDecimal
  • Pattern: ^-?\d+(\.\d{1,2})?$
Example"25.00"
orderDaterequired

Date the order was placed

  • Format: date
Example"2024-06-15"
orderNumberrequired

Human-readable order number

Example"SO-2024-00123"
orderStatusrequired

Current status of the order

Allowed values"PLANNED""CLOSED""RELEASED"
receiptsrequired
Show item fields
createdDaterequired

Date the receipt was created

  • Format: date
Example"2024-06-15"
grossAmountrequired

Gross amount including VAT

  • Format: BigDecimal
  • Pattern: ^-?\d+(\.\d{1,2})?$
Example"747.50"
idrequired
Example"01234567-89ab-cdef-0123-456789abcdef"
linesrequired
Show item fields
fulfilledQuantityrequired

Quantity fulfilled/picked

  • Format: BigDecimal
Example"2.0"
lineItemIdrequired

Reference to order line item

Example"01234567-89ab-cdef-0123-456789abcdef"
quantityrequired

Quantity invoiced

  • Format: BigDecimal
Example"2.0"
netAmountrequired

Net amount excluding VAT

  • Format: BigDecimal
  • Pattern: ^-?\d+(\.\d{1,2})?$
Example"598.00"
refundsrequired
Show item fields
createdDaterequired

Date the refund was created

  • Format: date
Example"2024-06-20"
grossAmountrequired

Gross refund amount including VAT

  • Format: BigDecimal
  • Pattern: ^-?\d+(\.\d{1,2})?$
Example"747.50"
grossReturnFeeAmountrequired

Gross return fee amount including VAT

  • Format: BigDecimal
  • Pattern: ^-?\d+(\.\d{1,2})?$
Example"59.00"
idrequired
Example"01234567-89ab-cdef-0123-456789abcdef"
linesrequired
Show item fields
lineItemIdrequired

Reference to order line item

Example"01234567-89ab-cdef-0123-456789abcdef"
quantityrequired

Quantity refunded

  • Format: BigDecimal
Example"1.0"
netAmountrequired

Net refund amount excluding VAT

  • Format: BigDecimal
  • Pattern: ^-?\d+(\.\d{1,2})?$
Example"598.00"
netReturnFeeAmountrequired

Net return fee amount excluding VAT

  • Format: BigDecimal
  • Pattern: ^-?\d+(\.\d{1,2})?$
Example"47.20"
statusrequired

Refund status

Allowed values"OPEN""CLOSED"
shipmentsrequired
Show item fields
captureIdrequired

Reference to the capture (picking list) this shipment originated from

Example"01234567-89ab-cdef-0123-456789abcdef"
createdDateoptional

Date the shipment was created

  • Format: date
Example"2024-06-16"
idrequired
Example"01234567-89ab-cdef-0123-456789abcdef"
linesrequired
Show item fields
lineItemIdrequired

Reference to order line item

Example"01234567-89ab-cdef-0123-456789abcdef"
quantityrequired

Quantity 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"
vouchersrequired
Show item fields
externalReferencerequired

External reference for the voucher

Example"abc123-promo-uuid"
titleoptional

Display 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/json
errorrequired

Stable error code

Example"INVALID_REQUEST"
messagerequired

Human-readable error message

Example"Invalid customer ID format"
resolutionrequired

Suggested next action

Example"Correct the customer ID and retry the request"
403
application/json
errorrequired

Stable error code

Example"INVALID_REQUEST"
messagerequired

Human-readable error message

Example"Invalid customer ID format"
resolutionrequired

Suggested 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/json
errorrequired

Stable error code

Example"INVALID_REQUEST"
messagerequired

Human-readable error message

Example"Invalid customer ID format"
resolutionrequired

Suggested next action

Example"Correct the customer ID and retry the request"
500
application/json
errorrequired

Stable error code

Example"INVALID_REQUEST"
messagerequired

Human-readable error message

Example"Invalid customer ID format"
resolutionrequired

Suggested next action

Example"Correct the customer ID and retry the request"