Skip to main content
Anchor to OrderDisplayFulfillmentStatus

OrderDisplayFulfillmentStatus

enum

Represents the order's aggregated fulfillment status for display purposes.

Displayed as Fulfilled. All the items in the order have been fulfilled.

Displayed as In progress. Some of the items in the order have been fulfilled, or a request for fulfillment has been sent to the fulfillment service.

Displayed as On hold. All of the unfulfilled items in this order are on hold.

Displayed as Open. None of the items in the order have been fulfilled. Replaced by "UNFULFILLED" status.

Displayed as Partially fulfilled. Some of the items in the order have been fulfilled.

Displayed as Pending fulfillment. A request for fulfillment of some items awaits a response from the fulfillment service. Replaced by the "IN_PROGRESS" status.

Displayed as Request declined. Some of the items in the order have been rejected for fulfillment by the fulfillment service.

Displayed as Restocked. All the items in the order have been restocked. Replaced by the "UNFULFILLED" status.

Displayed as Scheduled. All of the unfulfilled items in this order are scheduled for fulfillment at later time.

Displayed as Unfulfilled. None of the items in the order have been fulfilled.


Was this section helpful?

•OBJECT

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. 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 for apps that don't have a legitimate use for the associated data.


Learn more about building apps for orders and fulfillment.


Was this section helpful?