--- title: Order - GraphQL Admin description: >- The `Order` object represents a customer's request to purchase one or more products from a store. Use the `Order` object to handle the complete purchase lifecycle from checkout to fulfillment. Use the `Order` object when you need to: - Display order details on customer account pages or admin dashboards. - Create orders for phone sales, wholesale customers, or subscription services. - Update order information like shipping addresses, notes, or fulfillment status. - Process returns, exchanges, and partial refunds. - Generate invoices, receipts, and shipping labels. The `Order` object serves as the central hub connecting customer information, product details, payment processing, and fulfillment data within the GraphQL Admin API schema. > Note: > Only the last 60 days' worth of orders from a store are accessible from the `Order` object by default. If you want to access older records, > then you need to [request access to all orders](https://shopify.dev/docs/api/usage/access-scopes#orders-permissions). If your app is granted > access, then you can add the `read_all_orders`, `read_orders`, and `write_orders` scopes. > Caution: > Only use orders data if it's required for your app's functionality. Shopify will restrict [access to scopes](https://shopify.dev/docs/api/usage/access-scopes#requesting-specific-permissions) for apps that don't have a legitimate use for the associated data. Learn more about [building apps for orders and fulfillment](https://shopify.dev/docs/apps/build/orders-fulfillment). api_version: 2026-01 api_name: admin type: object api_type: graphql source_url: html: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/Order' md: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/Order.md' --- # Order object Requires `read_orders` access scope, `read_marketplace_orders` access scope or `read_quick_sale` access scope. The `Order` object represents a customer's request to purchase one or more products from a store. Use the `Order` object to handle the complete purchase lifecycle from checkout to fulfillment. Use the `Order` object when you need to: * Display order details on customer account pages or admin dashboards. * Create orders for phone sales, wholesale customers, or subscription services. * Update order information like shipping addresses, notes, or fulfillment status. * Process returns, exchanges, and partial refunds. * Generate invoices, receipts, and shipping labels. The `Order` object serves as the central hub connecting customer information, product details, payment processing, and fulfillment data within the GraphQL Admin API schema. *** Note Only the last 60 days' worth of orders from a store are accessible from the `Order` object by default. If you want to access older records, then you need to [request access to all orders](https://shopify.dev/docs/api/usage/access-scopes#orders-permissions). If your app is granted access, then you can add the `read_all_orders`, `read_orders`, and `write_orders` scopes. *** *** Caution Only use orders data if it's required for your app's functionality. Shopify will restrict [access to scopes](https://shopify.dev/docs/api/usage/access-scopes#requesting-specific-permissions) for apps that don't have a legitimate use for the associated data. *** Learn more about [building apps for orders and fulfillment](https://shopify.dev/docs/apps/build/orders-fulfillment). ## Fields * additionalFees * agreements * alerts * app * billingAddress * billingAddressMatchesShippingAddress * cancellation * cancelledAt * cancelReason * canMarkAsPaid * canNotifyCustomer * capturable * cartDiscountAmountSet * channelInformation * clientIp * closed * closedAt * confirmationNumber * confirmed * createdAt * currencyCode * currentCartDiscountAmountSet * currentShippingPriceSet * currentSubtotalLineItemsQuantity * currentSubtotalPriceSet * currentTaxLines * currentTotalAdditionalFeesSet * currentTotalDiscountsSet * currentTotalDutiesSet * currentTotalPriceSet * currentTotalTaxSet * currentTotalWeight * customAttributes * customer * customerAcceptsMarketing * customerJourneySummary * customerLocale * discountApplications * discountCode * discountCodes * displayAddress * displayFinancialStatus * displayFulfillmentStatus * disputes * dutiesIncluded * edited * email * estimatedTaxes * events * fulfillable * fulfillmentOrders * fulfillments * fulfillmentsCount * fullyPaid * hasTimelineComment * id * legacyResourceId * lineItems * localizedFields * merchantBusinessEntity * merchantEditable * merchantEditableErrors * merchantOfRecordApp * metafield * metafields * name * netPaymentSet * nonFulfillableLineItems * note * number * originalTotalAdditionalFeesSet * originalTotalDutiesSet * originalTotalPriceSet * paymentCollectionDetails * paymentGatewayNames * paymentTerms * phone * poNumber * presentmentCurrencyCode * processedAt * productNetwork * publication * purchasingEntity * refundable * refundDiscrepancySet * refunds * registeredSourceUrl * requiresShipping * restockable * retailLocation * returns * returnStatus * risk * shippingAddress * shippingLine * shippingLines * shopifyProtect * sourceIdentifier * sourceName * staffMember * statusPageUrl * subtotalLineItemsQuantity * subtotalPriceSet * suggestedRefund * tags * taxesIncluded * taxExempt * taxLines * test * totalCapturableSet * totalCashRoundingAdjustment * totalDiscountsSet * totalOutstandingSet * totalPriceSet * totalReceivedSet * totalRefundedSet * totalRefundedShippingSet * totalShippingPriceSet * totalTaxSet * totalTipReceivedSet * totalWeight * transactions * transactionsCount * unpaid * updatedAt ### Deprecated fields * cartDiscountAmount: deprecated * channel: deprecated * customerJourney: deprecated * landingPageDisplayText: deprecated * landingPageUrl: deprecated * localizationExtensions: deprecated * metafieldDefinitions: deprecated * netPayment: deprecated * physicalLocation: deprecated * referralCode: deprecated * referrerDisplayText: deprecated * referrerUrl: deprecated * riskLevel: deprecated * risks: deprecated * subtotalPrice: deprecated * totalCapturable: deprecated * totalDiscounts: deprecated * totalPrice: deprecated * totalReceived: deprecated * totalRefunded: deprecated * totalShippingPrice: deprecated * totalTax: deprecated * totalTipReceived: deprecated *** ## Map ### Fields and connections with this object * [CalculatedOrder.originalOrder](https://shopify.dev/docs/api/admin-graphql/latest/objects/CalculatedOrder#field-CalculatedOrder.fields.originalOrder) * [Company.orders](https://shopify.dev/docs/api/admin-graphql/latest/objects/Company#field-Company.fields.orders) * [CompanyContact.orders](https://shopify.dev/docs/api/admin-graphql/latest/objects/CompanyContact#field-CompanyContact.fields.orders) * [CompanyLocation.orders](https://shopify.dev/docs/api/admin-graphql/latest/objects/CompanyLocation#field-CompanyLocation.fields.orders) * [Customer.lastOrder](https://shopify.dev/docs/api/admin-graphql/latest/objects/Customer#field-Customer.fields.lastOrder) * [Customer.orders](https://shopify.dev/docs/api/admin-graphql/latest/objects/Customer#field-Customer.fields.orders) * [CustomerMergePreviewDefaultFields.orders](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerMergePreviewDefaultFields#field-CustomerMergePreviewDefaultFields.fields.orders) * [DraftOrder.order](https://shopify.dev/docs/api/admin-graphql/latest/objects/DraftOrder#field-DraftOrder.fields.order) * [Fulfillment.order](https://shopify.dev/docs/api/admin-graphql/latest/objects/Fulfillment#field-Fulfillment.fields.order) * [FulfillmentOrder.order](https://shopify.dev/docs/api/admin-graphql/latest/objects/FulfillmentOrder#field-FulfillmentOrder.fields.order) * [GiftCard.order](https://shopify.dev/docs/api/admin-graphql/latest/objects/GiftCard#field-GiftCard.fields.order) * [OrderAgreement.order](https://shopify.dev/docs/api/admin-graphql/latest/objects/OrderAgreement#field-OrderAgreement.fields.order) * [OrderConnection.nodes](https://shopify.dev/docs/api/admin-graphql/latest/connections/OrderConnection#returns-nodes) * [OrderEdge.node](https://shopify.dev/docs/api/admin-graphql/latest/objects/OrderEdge#field-OrderEdge.fields.node) * [OrderTransaction.order](https://shopify.dev/docs/api/admin-graphql/latest/objects/OrderTransaction#field-OrderTransaction.fields.order) * [PaymentTerms.order](https://shopify.dev/docs/api/admin-graphql/latest/objects/PaymentTerms#field-PaymentTerms.fields.order) * [Refund.order](https://shopify.dev/docs/api/admin-graphql/latest/objects/Refund#field-Refund.fields.order) * [Return.order](https://shopify.dev/docs/api/admin-graphql/latest/objects/Return#field-Return.fields.order) * [ReverseFulfillmentOrder.order](https://shopify.dev/docs/api/admin-graphql/latest/objects/ReverseFulfillmentOrder#field-ReverseFulfillmentOrder.fields.order) * [ShopPayPaymentRequestReceipt.order](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopPayPaymentRequestReceipt#field-ShopPayPaymentRequestReceipt.fields.order) * [ShopifyPaymentsDispute.order](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsDispute#field-ShopifyPaymentsDispute.fields.order) * [SubscriptionBillingCycleEditedContract.orders](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionBillingCycleEditedContract#field-SubscriptionBillingCycleEditedContract.fields.orders) * [SubscriptionContract.orders](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionContract#field-SubscriptionContract.fields.orders) * [SubscriptionContract.originOrder](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionContract#field-SubscriptionContract.fields.originOrder) * [SubscriptionContractBase.orders](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/SubscriptionContractBase#fields-orders) * [TenderTransaction.order](https://shopify.dev/docs/api/admin-graphql/latest/objects/TenderTransaction#field-TenderTransaction.fields.order) ### Possible type in * [Comment​Event​Embed](https://shopify.dev/docs/api/admin-graphql/latest/unions/CommentEventEmbed) * [Metafield​Reference](https://shopify.dev/docs/api/admin-graphql/latest/unions/MetafieldReference) * [Metafield​Referencer](https://shopify.dev/docs/api/admin-graphql/latest/unions/MetafieldReferencer) *** ## Queries * order * orderByIdentifier * orders *** ## Order Queries ### Queried by * [order](https://shopify.dev/docs/api/admin-graphql/latest/queries/order) * [order​By​Identifier](https://shopify.dev/docs/api/admin-graphql/latest/queries/orderByIdentifier) * [orders](https://shopify.dev/docs/api/admin-graphql/latest/queries/orders) *** ## Mutations * orderClose * orderCreate * orderCreateManualPayment * orderCustomerRemove * orderCustomerSet * orderEditCommit * orderInvoiceSend * orderMarkAsPaid * orderOpen * orderUpdate * refundCreate * taxSummaryCreate *** ## Order Mutations ### Mutated by * [order​Close](https://shopify.dev/docs/api/admin-graphql/latest/mutations/orderClose) * [order​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/orderCreate) * [order​Create​Manual​Payment](https://shopify.dev/docs/api/admin-graphql/latest/mutations/orderCreateManualPayment) * [order​Customer​Remove](https://shopify.dev/docs/api/admin-graphql/latest/mutations/orderCustomerRemove) * [order​Customer​Set](https://shopify.dev/docs/api/admin-graphql/latest/mutations/orderCustomerSet) * [order​Edit​Commit](https://shopify.dev/docs/api/admin-graphql/latest/mutations/orderEditCommit) * [order​Invoice​Send](https://shopify.dev/docs/api/admin-graphql/latest/mutations/orderInvoiceSend) * [order​Mark​As​Paid](https://shopify.dev/docs/api/admin-graphql/latest/mutations/orderMarkAsPaid) * [order​Open](https://shopify.dev/docs/api/admin-graphql/latest/mutations/orderOpen) * [order​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/orderUpdate) * [refund​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/refundCreate) * [tax​Summary​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/taxSummaryCreate) *** ## Interfaces * CommentEventSubject * HasEvents * HasLocalizationExtensions * HasLocalizedFields * HasMetafieldDefinitions * HasMetafields * LegacyInteroperability * Node *** ## Order Implements ### Implements * [Comment​Event​Subject](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/CommentEventSubject) * [Has​Events](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasEvents) * [Has​Localization​Extensions](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasLocalizationExtensions) * [Has​Localized​Fields](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasLocalizedFields) * [Has​Metafield​Definitions](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasMetafieldDefinitions) * [Has​Metafields](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasMetafields) * [Legacy​Interoperability](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/LegacyInteroperability) * [Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)