🔒
Requires read_order access scope. More access scope

The Get Order Details by Number API retrieves detailed information about a specific order using its unique order number. This enables users to fetch comprehensive details, such as order status, customer information, shipping details, billing details, and line items.

This API is especially useful for:

Querying order details for customer support or review.
Validating order information for analytics or reporting.
Checking the financial, fulfillment, and shipping statuses.

Request Parameters

Public Request Parameters

📘
Public Request Parameters

Path Parameters

Name	Type	Required	Description
`number`	`string`	Yes	Order number, intended to simplify merchant references.

Response Explanation

Public Response Parameters

📘
Public Response Parameters

Success Response

Object	Fields	Type	Desc
Order	id	string	Unique identifier for the order.
	number	string	Order number, intended to simplify merchant references.
	note	string	A custom note input by the merchant regarding the order.
	status	string	The current Order status
	financial_status	string	Indicates the payment status of the order
	fulfillment_status	string	Represents the shipping or fulfillment progress of the order
	email_status	string	The status of recall emails for the order. `waiting` means “pending to send” `send` means “sent”
	cancel_reason	string	Reason for order cancellation, if applicable.
	recovery_status	string	The recovery_status field tracks the progress of an order recall process `waiting` means “Waiting to be recalled” `sending` means “Recall notification in progress” `recalling` means “Recall in progress)” `failed` means “Recall failed)” `success` means “Recall successful)”
	payment_method	string	The payment method used for the order (e.g., apple_pay, credit_card, online).
	~~discount_code~~	string	@Deprecated.
	discount_applications	string	Details of discounts
	customer_note	string	A note provided by the customer during checkout.
	~~landing_site~~	string	@Deprecated.
	buyer_accepts_marketing	bool	Indicates whether the customer has agreed to receive marketing promotions.
	currency	string	Currency code for the order
	total_price	string	The final price paid by the customer, including taxes, discounts, tips, additional fee and shipping fees.
	sub_total	string	The sum of the prices for all line items in the order. If order.config.product_tax_included is true, the amount includes total_tax (excluding shipping_tax_total); otherwise, it excludes tax. Formula: sub_total = sum(line_item.price * line_item.quantity).
	total_discount	string	Total amount of discounts applied to the order, including product, shipping, and payment discounts.
	total_tax	string	Total tax amount applied to the products in the order， excluding shipping tax.
	total_shipping	string	Total shipping fee for the order.
	code_discount_total	string	Total discount from discount codes applied to the order.
	~~line_item_discount_total~~	string	@Deprecated.total Product discount, numeric string, for example: `"9.99"`,includes code_discount_total
	gift_card_total	string	Gift card discount amount, numeric string, for example: `"9.99"`
	total_refund_price	string	Total refund amount has been successfully processed, numeric string, for example: `"9.99"`
	~~total_refund_discount~~	string	@Deprecated.Total discount refunded, numeric string, for example: `"9.99"`
	additional_total	string	Total amount of additional charges, numeric string, for example: `"9.99"`
	additional_prices	array of object	the detail list of additional charges
	additional_prices.name	string	Name of the additional charge.
	additional_prices.price	string	Amount of the additional charge.
	additional_prices.fee_title	string	Custom Charge Name
	~~total_refund_tax~~	string	@Deprecated.
	shipping_tax_total	string	Total shipping tax amount of the order.
	customer_deleted_at	string	Timestamp indicating when the customer associated with the order was deleted.
	created_at	string	Timestamp indicating when the order was created.
	updated_at	string	Timestamp indicating when the order was updated.
	deleted_at	string	Timestamp indicating when the order was deleted.
	canceled_at	string	Timestamp indicating when the order was canceled.
	placed_at	string	Timestamp indicating when the order was paid.
	total_tip_received	string	Total amount of tips received for the order.
	tags	string	Custom tags added to the order by merchants or the system.
	~~browser_ip~~	string	@Deprecated. IP address of the customer who placed the order.
	~~last_landing_url~~	string	@Deprecated. URL of the last page visited by the customer before checkout.
	total_paid	string	Total amount paid by the customer for the order.
	~~source~~	string	@Deprecated.Product source url
	~~source_name~~	object	@Deprecated. Product source
	~~source_name.data~~	string	@Deprecated. Product source
	~~source_name.created_at~~	string	@Deprecated. Timestamp of the creation
	~~last_referrer_show~~	object	@Deprecated. Last interaction source
	~~last_referrer_show.data~~	string	@Deprecated. Interaction source data.
	~~last_referrer_show.created_at~~	string	@Deprecated. Timestamp of the last interaction.
	shipping_line	object	Information about the shipping plan selected for the order.
	shipping_line.name	string	Name of the shipping plan.
	customer	Customer	Customer details
	shipping_address	Address	Delivery address
	billing_address	Address	Billing address
	payment_line	PaymentLine	Payment details
	line_items	array of LineItem	List of purchased products
	fulfillments	array of Fulfillment	List of fulfillments
	logistics_code	string	Logistics code
	refer_info	string	Visit information
	config	OrderConfig	Order configuration information
	sales_platform	string	Platform where the order was placed
	checkout_url	string	The checkout page url for the order with storeDomain
	location_line	LocationLine	Merchant's warehouse address.
	invoice_url	string	The checkout page url for the order without storeDomain
	duty_total	string	Total Duty Amount

Error Response

Error responses in the API can be represented using two different fields: errors and error. Both fields provide details about issues encountered during request processing. Below is an explanation of the fields with their respective examples and descriptions.

Field	Type	Example	Description
`errors`	Array	`[ "file number error"]`	A list of errors encountered during the request processing.

Field	Type	Example	Description
`error`	String	`"store is not active"`	Indicates an error encountered during the process

Error Detail

Status Code	Message	Possible Reason	Example Response
400	Bad Request	Invalid input format or request structure (e.g., missing required fields or incorrect data types).	`Bad Request`
	Unauthorized	The request is missing valid authentication credentials or the credentials provided are invalid.	`Unauthorized`
404	Not Found	Order's number is empty or not found.	"Unable to find resource"

API Structure Overview