> ## Documentation Index
> Fetch the complete documentation index at: https://redo-44af351d-docs-v3-graphql-api-reference.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# order
> Fetch a single order by its id (a branded order id or a legacy Mongo ObjectId hex).
**Required scopes:**
[`orders_read`](/docs/api-reference/v3/reference/scopes#scope-orders_read)
## Arguments
The id of the order to fetch: a branded order id or a 24-char Mongo ObjectId
hex.
## Returns
Order}>
A customer order ingested from the merchant's ecommerce platform.
DateTime!} required>
When the order was placed (the ecommerce provider's creation time, falling back to Redo's ingestion time).
The ISO 4217 currency code the order was placed in.
OrderCustomer}>
The customer who placed the order, if known.
The customer's email address.
The customer's first (given) name.
The customer's id in the source platform.
The customer's last (family) name.
The customer's full name, when both name parts are set.
The customer's phone number.
The order's id in the source ecommerce platform.
[OrderFulfillment!]!} required>
The shipments fulfilling this order's items.
DateTime!} required>
When the fulfillment was created.
DateTime}>
When the shipment was delivered, if it has been.
Date}>
The carrier's estimated delivery date (YYYY-MM-DD, destination-local), if known.
The fulfillment's id in the source platform.
[OrderFulfillmentLineItem!]!} required>
The items included in this fulfillment.
The fulfilled line item's id in the source platform.
The product's id in the source platform.
How many units of this item were fulfilled.
The stock keeping unit of the fulfilled item.
The product title of the fulfilled item.
The variant's id in the source platform.
OrderFulfillmentStatus!} required>
The current tracked shipment status.
The shipping carrier, if known.
[OrderTrackingEvent!]!} required>
The carrier tracking events, oldest to newest.
DateTime!} required>
When the tracking event occurred.
OrderTrackingEventLocation}>
Where the tracking event occurred, if reported.
The human-readable tracking message.
The carrier's status label at this event.
The carrier tracking number, if known.
The id of this order.
The order's legacy Mongo ObjectId (24-char hex) from before the CockroachDB migration.
[OrderLineItem!]!} required>
The items purchased on this order.
Money}>
The total discount applied to this line item.
Decimal!} required>
The exact amount as a decimal string (e.g. "19.99").
ISO 4217 currency code (e.g. USD).
The line item's id in the source platform.
A URL to the item's image, if any.
Money}>
The per-unit price before discounts.
Decimal!} required>
The exact amount as a decimal string (e.g. "19.99").
ISO 4217 currency code (e.g. USD).
The purchased product's id in the source platform.
How many units of this item were ordered.
The stock keeping unit for this line item.
The product title for this line item.
The purchased variant's id in the source platform.
OrderShipping}>
The order's shipping method, cost, and destination.
MailingAddress}>
The destination the order ships to.
The first line of the address (street and number).
The second line of the address (apartment, suite, unit, etc.).
The city, town, or village.
The country.
The postal or ZIP code.
The province, state, or region.
Money}>
What the customer paid for shipping.
Decimal!} required>
The exact amount as a decimal string (e.g. "19.99").
ISO 4217 currency code (e.g. USD).
The selected shipping method's name, e.g. Standard.
Money}>
The order subtotal, excluding tax and shipping, if known.
Decimal!} required>
The exact amount as a decimal string (e.g. "19.99").
ISO 4217 currency code (e.g. USD).
Free-form tags applied to the order.
Money}>
The order total, including tax and shipping, if known.
Decimal!} required>
The exact amount as a decimal string (e.g. "19.99").
ISO 4217 currency code (e.g. USD).
Money}>
The total tax charged on the order, if known.
Decimal!} required>
The exact amount as a decimal string (e.g. "19.99").
ISO 4217 currency code (e.g. USD).
## Example
```graphql theme={null}
query {
order(id: "...") {
createdAt
currencyCode
externalId
id
legacyId
tags
}
}
```