Returns a list of orders placed in the store, including data such as order status, customer, and line item details. Use the orders query to build reports, analyze sales performance, or automate fulfillment workflows. The orders query supports pagination, sorting, and filtering.
The elements that come after the specified cursor.
The elements that come before the specified cursor.
A filter made up of terms, connectives, modifiers, and comparators. You can apply one or more filters to a query. Learn more about Shopify API search syntax.
Filter by a case-insensitive search of multiple fields in a document.
Example:
query=Bob Normanquery=title:green hoodieFilter by the cart token's unique value to track abandoned cart conversions or troubleshoot checkout issues. The token references the cart that's associated with an order.
Example:
cart_token:abc123Filter by the channel information handle (ChannelInformation.channelDefinition.handle) field.
Example:
channel:webchannel:web,posFilter by the channel id field.
Filter by the order's chargeback status. A chargeback occurs when a customer questions the legitimacy of a charge with their financial institution.
Valid values:
acceptedcharge_refundedlostneeds_responseunder_reviewwonExample:
chargeback_status:acceptedFilter by the checkout token's unique value to analyze conversion funnels or resolve payment issues. The checkout token's value references the checkout that's associated with an order.
Example:
checkout_token:abc123Filter by the randomly generated alpha-numeric identifier for an order that can be displayed to the customer instead of the sequential order name. This value isn't guaranteed to be unique.
Example:
confirmation_number:ABC123Filter by the date and time when the order was created in Shopify's system.
Example:
created_at:2020-10-21T23:39:20Zcreated_at:<nowcreated_at:<=2024Filter by the last four digits of the payment card that was used to pay for the order. This filter matches only the last four digits of the card for heightened security.
Example:
credit_card_last4:1234Filter orders by the customer id field.
Filter by the delivery methodType field.
Valid values:
shippingpick-upretaillocalpickup-pointnoneExample:
delivery_method:shippingFilter by the case-insensitive discount code that was applied to the order at checkout. Maximum characters: 255.
Example:
discount_code:ABC123Filter by the email address that's associated with the order to provide customer support or analyze purchasing patterns.
Example:
email:example@shopify.comFilter by the order displayFinancialStatus field.
Valid values:
paidpendingauthorizedpartially_paidpartially_refundedrefundedvoidedexpiredExample:
financial_status:authorizedFilter by the level of fraud protection that's applied to the order. Use this filter to manage risk or handle disputes.
Valid values:
fully_protectedpartially_protectednot_protectedpendingnot_eligiblenot_availableExample:
fraud_protection_level:fully_protectedFilter by the fulfillment location id (Fulfillment.location.id) field.
Example:
fulfillment_location_id:123Filter by the displayFulfillmentStatus field to prioritize shipments or monitor order processing.
Valid values:
unshippedshippedfulfilledpartialscheduledon_holdunfulfilledrequest_declinedExample:
fulfillment_status:fulfilledFilter by the paymentGatewayNames field. Use this filter to find orders that were processed through specific payment providers like Shopify Payments, PayPal, or other custom payment gateways.
Example:
gateway:shopify_paymentsFilter by id range.
Example:
id:1234id:>=1234id:<=1234Filter by the location id that's associated with the order to view and manage orders for specific locations. For POS orders, locations must be defined in the Shopify admin under Settings > Locations. If no ID is provided, then the primary location of the shop is returned.
Filters resources by metafield value. Format: metafields.{namespace}.{key}:{value}. Learn more about querying by metafield value.
Example:
metafields.custom.on_sale:truemetafields.product.material:"gid://shopify/Metaobject/43458085"Filter by the order name field.
Filter by the payment ID that's associated with the order to reconcile financial records or troubleshoot payment issues.
Example:
payment_id:abc123Filter by the ID of the payment provider that's associated with the order to manage payment methods or troubleshoot transactions.
Example:
payment_provider_id:123Filter by the order poNumber field.
Example:
po_number:P01001Filter by the order processedAt field.
Example:
processed_at:2021-01-01T00:00:00ZFilter by the ID of a location that's associated with the order, such as locations from fulfillments, refunds, or the shop's primary location.
Example:
reference_location_id:123Filter by the order's returnStatus to monitor returns processing and track which orders have active returns.
Valid values:
return_requestedin_progressinspection_completereturnedreturn_failedno_returnExample:
return_status:in_progressFilter by the order risk assessment riskLevel field.
Valid values:
highmediumlownonependingFilter by the sales channel where the order was made to analyze performance or manage fulfillment processes.
Example:
sales_channel: some_sales_channelFilter by the ID of the order placed on the originating platform, such as a unique POS or third-party identifier. This value doesn't correspond to the Shopify ID that's generated from a completed draft order.
Example:
source_identifier:1234-12-1000Filter by the platform where the order was placed to distinguish between web orders, POS sales, draft orders, or third-party channels. Use this filter to analyze sales performance across different ordering methods.
Example:
source_name:websource_name:shopify_draft_orderFilter by the order's status to manage workflows or analyze the order lifecycle.
Valid values:
openclosedcancellednot_closedFilter by the total number of items across all line items in an order. This filter supports both exact values and ranges, and is useful for identifying bulk orders or analyzing purchase volume patterns.
Example:
subtotal_line_items_quantity:10subtotal_line_items_quantity:5..20Filter objects by the tag field.
Filter by objects that don’t have the specified tag.
Filter by test orders. Test orders are made using the Shopify Bogus Gateway or a payment provider with test mode enabled.
Filter by the date and time when the order was last updated in Shopify's system.
Example:
updated_at:2020-10-21T23:39:20Zupdated_at:<nowupdated_at:<=2024Reverse the order of the underlying list.
The ID of a saved search. The search’s query string is used as the query argument.
The connection between the node and its parent. Each edge contains a minimum of the edge's cursor and the node.
A list of nodes that are contained in OrderEdge. You can fetch data about an individual node, or you can follow the edges to fetch data about a collection of related nodes. At each node, you specify the fields that you want to retrieve.
query { orders(first: 10) { edges { cursor node { id } } pageInfo { hasNextPage hasPreviousPage startCursor endCursor } } }curl -X POST \ https://your-development-store.myshopify.com/admin/api/2025-07/graphql.json \ -H 'Content-Type: application/json' \ -H 'X-Shopify-Access-Token: {access_token}' \ -d '{ "query": "query { orders(first: 10) { edges { cursor node { id } } pageInfo { hasNextPage hasPreviousPage startCursor endCursor } } }" }'const { admin } = await authenticate.admin(request); const response = await admin.graphql( `#graphql query { orders(first: 10) { edges { cursor node { id } } pageInfo { hasNextPage hasPreviousPage startCursor endCursor } } }`, ); const data = await response.json();const client = new shopify.clients.Graphql({session}); const data = await client.query({ data: `query { orders(first: 10) { edges { cursor node { id } } pageInfo { hasNextPage hasPreviousPage startCursor endCursor } } }`, });session = ShopifyAPI::Auth::Session.new( shop: "your-development-store.myshopify.com", access_token: access_token ) client = ShopifyAPI::Clients::Graphql::Admin.new( session: session ) query = <<~QUERY query { orders(first: 10) { edges { cursor node { id } } pageInfo { hasNextPage hasPreviousPage startCursor endCursor } } } QUERY response = client.query(query: query)
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4