---
url: https://docs.youcan.shop/themes/objects/order.md
---

# `order` object

A completed order. Available in the [`thankyou`](/themes/templates/template-types/thankyou), [`upsell`](/themes/templates/template-types/upsell) and [`customer-order`](/themes/templates/template-types/customer-order) templates, and from [`customer.orders`](customer) and `customer.last_order`.

## Properties

***

| Name                | Type                                                                        | Description                                                        |
| ------------------- | -------------------------------------------------------------------------- | ---------------------------------------------------------------- |
| `id`                | [string](../basics/types#string)                                            | Order identifier                                                  |
| `ref`               | [string](../basics/types#string)                                            | Order reference, for example `1042`                               |
| `name`              | [string](../basics/types#string)                                            | Order reference with a `#`, for example `#1042`                   |
| `created_at`        | [string](../basics/types#string)                                            | The date of the order, in ISO 8601                                |
| `financial_status`  | [string](../basics/types#string)                                            | Payment status slug, for example `paid` or `pending`              |
| `fulfillment_status` | [string](../basics/types#string)                                           | Shipping status slug, for example `fulfilled` or `unfulfilled`, or nil |
| `customer_url`      | [string](../basics/types#string)                                            | The URL of the order page in the customer account                 |
| `shipping_address`  | [address](address) object or `null`                                         | The shipping address                                              |
| `paymentStatus`     | [string](../basics/types#string)                                            | Human-readable payment status                                     |
| `paymentStatusSlug` | [string](../basics/types#string)                                            | Machine-readable payment status slug                              |
| `gatewayType`       | [string](../basics/types#string)                                            | Payment gateway used                                              |
| `shippingCost`      | [string](../basics/types#string)                                            | Shipping cost. `0` or `null` means free shipping                  |
| `sub_total`         | [number](../basics/types#number)                                            | Order items subtotal                                              |
| `total`             | [number](../basics/types#number)                                            | Order total, including VAT, shipping, and any coupon discount     |
| `total_tax_amount`  | [number](../basics/types#number)                                            | Total tax amount                                                  |
| `vat`               | [number](../basics/types#number)                                            | VAT rate as a fraction (for example, `0.2` for 20%)              |
| `order_variants`    | [array](../basics/types#array) of [order\_variant](order_variant) object     | The purchased product variants                                    |
| `coupon`            | [coupon](coupon) object or `null`                                           | The coupon applied to the order, if any                           |
| `metafields`        | [array](../basics/types#array)                                              | Order metafields                                                  |