Orders

Returns a list of orders placed. An order is a customer's request to purchase one or more products from a shop.

Field

Description

Field

Description

Billing address matches shipping address

Whether the billing address matches the shipping address.

Can mark as paid

Whether the order can be manually marked as paid.

Can notify customer

Whether notifications can be sent to the customer.

Cancel reason

Reason the order was canceled. Returns null if the order wasn't canceled.

Cancelled at

The date and time when the order was canceled. Returns null if the order wasn't canceled.

Capturable

Whether payment for the order can be captured. Returns true when the customer's credit card has been authorized for payment and the authorization period has not expired.

Client IP

The IP address of the client that is associated with this order.

Closed

Whether the order is closed.

Closed at

Date and time when the order closed. If the order is not closed, then this field returns null.

Confirmed

Whether inventory has been reserved for the order.

Created at

Date and time when the order was created in Shopify.

Currency code

The currency of the store at the time of the order. If payment hasn't occurred, then this field returns null.

Current subtotal line items quantity

The sum of the quantities for the line items that contribute to the order's subtotal. This doesn't include returned quantities.

Current total weight

The total weight (grams) of the order minus the weights for line items that have been returned.

Customer accepts marketing

Whether the customer agreed to receive marketing materials.

Customer locale

A two-letter or three-letter language code, optionally followed by a region modifier. Example values could be 'en', 'en-CA', 'en-PIRATE'.

Discount code

Discount code provided by the customer.

Display financial status

Financial status of the order that can be shown to the merchant. This field does not capture all the possible details of an order's financial state and should only be used for display summary purposes.

Display fulfillment status

Fulfillment status for the order that can be shown to the merchant. This field does not capture all the possible details of an order's fulfillment state. It should only be used for display summary purposes.

Edited

Whether the order has had any edits applied.

Email

The email address associated with the customer.

Fulfillable

Whether there are items that can be fulfilled. This field returns false after an order is completely fulfilled, or completely refunded without any fulfillments.

Fully paid

Whether the order has been paid in full.

Has timeline comment

Whether the merchant added timeline comments to the order.

ID

Globally unique ID.

Legacy resource ID

The ID of the corresponding resource in the REST Admin API.

Merchant editable

Whether the order can be edited by the merchant.

Name

Unique identifier for the order that appears on the order. For example, #1000 or _Store1001. This value is not unique across multiple stores.

Note

Contents of the note associated with the order.

Payment gateway names

List of all payment gateways used for the order. For example, authorize_net and Cash on Delivery (COD).

Phone

The phone number associated with the customer.

Presentment currency code

The payment currency of the customer for this order.

Processed at

Date and time when the order was processed. When orders are imported from an app, this date and time may not match the date and time when the order was created.

Refundable

Whether the order can be refunded.

Requires shipping

Whether any line item on the order requires physical shipping.

Restockable

Whether any line item on the order can be restocked.

Risk level

Fraud risk level of the order.

Subtotal line items quantity

The sum of the quantities for the line items that contribute to the order's subtotal.

Tags

A comma separated list of tags associated with the order.

Taxes included

Whether taxes are included in the subtotal price of the order.

Test

Whether the order is a test. Test orders are made using the Shopify Bogus Gateway or a payment provider with test mode enabled. A test order cannot be converted into a real order and vice versa.

Total tax

Total of all taxes applied to the order.

Total weight

The total weight of the order in grams. The total isn't adjusted for returns or removals. For the total with returns or removals, use currentTotalWeight.

Unpaid

Whether no payments have been made for the order.

Updated at

Date and time when the order was last modified.

totalRefunded

Total amount refunded for the order.

Mailing address provided by the customer. Not all orders have mailing addresses.

Field

Description

Field

Description

City

The name of the city, district, village, or town.

Company

The name of the customer's company or organization.

Country

The name of the country.

Country code

The two-letter code for the country of the address. For example, US.

First line

The first line of the address. Typically the street address or PO Box number.

First name

The first name of the customer.

Formatted

A formatted version of the address, customized by the provided arguments.

Formatted area

A comma-separated list of the values for city, province, and country.

ID

Globally unique ID.

Last name

The last name of the customer.

Latitude

The latitude coordinate of the customer address.

Longitude

The longitude coordinate of the customer address.

Name

The full name of the customer, based on firstName and lastName.

Phone

A unique phone number for the customer. Formatted using E.164 standard. For example, +16135551111.

Province

The region of the address, such as the province, state, or district.

Province code

The two-letter code for the region. For example, ON.

Second line

The second line of the address. Typically the number of the apartment, suite, or unit.

Zip

The zip or postal code of the address.

The amount of the order-level discount, which doesn't contain any line item discounts.

Field

Description

Field

Description

Presentment money amount

Amount in presentment currency.

Presentment money currency code

Currency code of the amount in presentment currency.

Shop money amount

Amount in shop currency.

Shop money currency code

Currency code of the amount in shop currency.

Details about the channel that created the order.

Field

Description

Field

Description

Channel ID

The unique identifier for the channel.

ID

Globally unique ID.

The channel definition associated with the channel.

Field

Description

Field

Description

Channel name

Name of the channel that this sub channel belongs to.

Handle

Unique string used as a public identifier for the channel definition.

ID

The unique identifier for the channel definition.

Sub channel name

Name of the sub channel (e.g. Online Store, Instagram Shopping, TikTok Live).

Svg icon

Icon displayed when showing the channel in admin.