--- title: Fulfillment - GraphQL Admin description: |- Represents a fulfillment. In Shopify, a fulfillment represents a shipment of one or more items in an order. When an order has been completely fulfilled, it means that all the items that are included in the order have been sent to the customer. There can be more than one fulfillment for an order. api_version: 2025-04 api_name: admin type: object api_type: graphql source_url: html: https://shopify.dev/docs/api/admin-graphql/2025-04/objects/fulfillment md: https://shopify.dev/docs/api/admin-graphql/2025-04/objects/fulfillment.md --- # Fulfillment object Requires `read_orders` access scope, `read_marketplace_orders` access scope, `read_assigned_fulfillment_orders` access scope, `read_merchant_managed_fulfillment_orders` access scope, `read_third_party_fulfillment_orders` access scope or `read_marketplace_fulfillment_orders` access scope. Represents a fulfillment. In Shopify, a fulfillment represents a shipment of one or more items in an order. When an order has been completely fulfilled, it means that all the items that are included in the order have been sent to the customer. There can be more than one fulfillment for an order. ## Fields * created​At [Date​Time!](https://shopify.dev/docs/api/admin-graphql/2025-04/scalars/DateTime) non-null The date and time when the fulfillment was created. * delivered​At [Date​Time](https://shopify.dev/docs/api/admin-graphql/2025-04/scalars/DateTime) The date that this fulfillment was delivered. * display​Status [Fulfillment​Display​Status](https://shopify.dev/docs/api/admin-graphql/2025-04/enums/FulfillmentDisplayStatus) Human readable display status for this fulfillment. * estimated​Delivery​At [Date​Time](https://shopify.dev/docs/api/admin-graphql/2025-04/scalars/DateTime) The estimated date that this fulfillment will arrive. * events [Fulfillment​Event​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-04/connections/FulfillmentEventConnection) non-null The history of events associated with this fulfillment. * first [Int](https://shopify.dev/docs/api/admin-graphql/2025-04/scalars/Int) ### Arguments The first `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql). * after [String](https://shopify.dev/docs/api/admin-graphql/2025-04/scalars/String) The elements that come after the specified [cursor](https://shopify.dev/api/usage/pagination-graphql). * last [Int](https://shopify.dev/docs/api/admin-graphql/2025-04/scalars/Int) The last `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql). * before [String](https://shopify.dev/docs/api/admin-graphql/2025-04/scalars/String) The elements that come before the specified [cursor](https://shopify.dev/api/usage/pagination-graphql). * reverse [Boolean](https://shopify.dev/docs/api/admin-graphql/2025-04/scalars/Boolean) Default:false Reverse the order of the underlying list. * sort​Key [Fulfillment​Event​Sort​Keys](https://shopify.dev/docs/api/admin-graphql/2025-04/enums/FulfillmentEventSortKeys) Default:HAPPENED\_AT Sort the underlying list using a key. If your query is slow or returns an error, then [try specifying a sort key that matches the field used in the search](https://shopify.dev/api/usage/pagination-graphql#search-performance-considerations). *** * fulfillment​Line​Items [Fulfillment​Line​Item​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-04/connections/FulfillmentLineItemConnection) non-null List of the fulfillment's line items. * first [Int](https://shopify.dev/docs/api/admin-graphql/2025-04/scalars/Int) ### Arguments The first `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql). * after [String](https://shopify.dev/docs/api/admin-graphql/2025-04/scalars/String) The elements that come after the specified [cursor](https://shopify.dev/api/usage/pagination-graphql). * last [Int](https://shopify.dev/docs/api/admin-graphql/2025-04/scalars/Int) The last `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql). * before [String](https://shopify.dev/docs/api/admin-graphql/2025-04/scalars/String) The elements that come before the specified [cursor](https://shopify.dev/api/usage/pagination-graphql). * reverse [Boolean](https://shopify.dev/docs/api/admin-graphql/2025-04/scalars/Boolean) Default:false Reverse the order of the underlying list. *** * fulfillment​Orders [Fulfillment​Order​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-04/connections/FulfillmentOrderConnection) non-null A paginated list of fulfillment orders for the fulfillment. * first [Int](https://shopify.dev/docs/api/admin-graphql/2025-04/scalars/Int) ### Arguments The first `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql). * after [String](https://shopify.dev/docs/api/admin-graphql/2025-04/scalars/String) The elements that come after the specified [cursor](https://shopify.dev/api/usage/pagination-graphql). * last [Int](https://shopify.dev/docs/api/admin-graphql/2025-04/scalars/Int) The last `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql). * before [String](https://shopify.dev/docs/api/admin-graphql/2025-04/scalars/String) The elements that come before the specified [cursor](https://shopify.dev/api/usage/pagination-graphql). * reverse [Boolean](https://shopify.dev/docs/api/admin-graphql/2025-04/scalars/Boolean) Default:false Reverse the order of the underlying list. *** * id [ID!](https://shopify.dev/docs/api/admin-graphql/2025-04/scalars/ID) non-null A globally-unique ID. * in​Transit​At [Date​Time](https://shopify.dev/docs/api/admin-graphql/2025-04/scalars/DateTime) The date and time when the fulfillment went into transit. * legacy​Resource​Id [Unsigned​Int64!](https://shopify.dev/docs/api/admin-graphql/2025-04/scalars/UnsignedInt64) non-null The ID of the corresponding resource in the REST Admin API. * location [Location](https://shopify.dev/docs/api/admin-graphql/2025-04/objects/Location) The location that the fulfillment was processed at. * name [String!](https://shopify.dev/docs/api/admin-graphql/2025-04/scalars/String) non-null Human readable reference identifier for this fulfillment. * order [Order!](https://shopify.dev/docs/api/admin-graphql/2025-04/objects/Order) non-null The order for which the fulfillment was created. * origin​Address [Fulfillment​Origin​Address](https://shopify.dev/docs/api/admin-graphql/2025-04/objects/FulfillmentOriginAddress) The address at which the fulfillment occurred. This field is intended for tax purposes, as a full address is required for tax providers to accurately calculate taxes. Typically this is the address of the warehouse or fulfillment center. To retrieve a fulfillment location's address, use the `assignedLocation` field on the [`FulfillmentOrder`](https://shopify.dev/docs/api/admin-graphql/latest/objects/FulfillmentOrder) object instead. * requires​Shipping [Boolean!](https://shopify.dev/docs/api/admin-graphql/2025-04/scalars/Boolean) non-null Whether any of the line items in the fulfillment require shipping. * service [Fulfillment​Service](https://shopify.dev/docs/api/admin-graphql/2025-04/objects/FulfillmentService) Fulfillment service associated with the fulfillment. * status [Fulfillment​Status!](https://shopify.dev/docs/api/admin-graphql/2025-04/enums/FulfillmentStatus) non-null The status of the fulfillment. * total​Quantity [Int!](https://shopify.dev/docs/api/admin-graphql/2025-04/scalars/Int) non-null Sum of all line item quantities for the fulfillment. * tracking​Info [\[Fulfillment​Tracking​Info!\]!](https://shopify.dev/docs/api/admin-graphql/2025-04/objects/FulfillmentTrackingInfo) non-null Tracking information associated with the fulfillment, such as the tracking company, tracking number, and tracking URL. * first [Int](https://shopify.dev/docs/api/admin-graphql/2025-04/scalars/Int) ### Arguments Truncate the array result to this size. *** * updated​At [Date​Time!](https://shopify.dev/docs/api/admin-graphql/2025-04/scalars/DateTime) non-null The date and time when the fulfillment was last modified. *** ## Map ### Fields and connections with this object * <->[FulfillmentConnection.nodes](https://shopify.dev/docs/api/admin-graphql/2025-04/connections/FulfillmentConnection#returns-nodes) * {}[FulfillmentEdge.node](https://shopify.dev/docs/api/admin-graphql/2025-04/objects/FulfillmentEdge#field-FulfillmentEdge.fields.node) * {}[FulfillmentOrder.fulfillments](https://shopify.dev/docs/api/admin-graphql/2025-04/objects/FulfillmentOrder#field-FulfillmentOrder.fields.fulfillments) * {}[Order.fulfillments](https://shopify.dev/docs/api/admin-graphql/2025-04/objects/Order#field-Order.fields.fulfillments) * {}[ReturnableFulfillment.fulfillment](https://shopify.dev/docs/api/admin-graphql/2025-04/objects/ReturnableFulfillment#field-ReturnableFulfillment.fields.fulfillment) *** ## Queries * [fulfillment](https://shopify.dev/docs/api/admin-graphql/2025-04/queries/fulfillment) query Returns a Fulfillment resource by ID. * id [ID!](https://shopify.dev/docs/api/admin-graphql/2025-04/scalars/ID) required ### Arguments The ID of the Fulfillment to return. *** *** ## \Fulfillment Queries ### Queried by * \[fulfillment](https://shopify.dev/docs/api/admin-graphql/2025-04/queries/fulfillment) *** ## Mutations * [fulfillment​Cancel](https://shopify.dev/docs/api/admin-graphql/2025-04/mutations/fulfillmentCancel) mutation Cancels a fulfillment. * id [ID!](https://shopify.dev/docs/api/admin-graphql/2025-04/scalars/ID) required ### Arguments The ID of the fulfillment to be canceled. *** * [fulfillment​Create](https://shopify.dev/docs/api/admin-graphql/2025-04/mutations/fulfillmentCreate) mutation Creates a fulfillment for one or many fulfillment orders. The fulfillment orders are associated with the same order and are assigned to the same location. * fulfillment [Fulfillment​Input!](https://shopify.dev/docs/api/admin-graphql/2025-04/input-objects/FulfillmentInput) required ### Arguments The input fields used to create a fulfillment from fulfillment orders. * message [String](https://shopify.dev/docs/api/admin-graphql/2025-04/scalars/String) An optional message for the fulfillment request. *** * [fulfillment​Tracking​Info​Update](https://shopify.dev/docs/api/admin-graphql/2025-04/mutations/fulfillmentTrackingInfoUpdate) mutation Updates tracking information for a fulfillment. * fulfillment​Id [ID!](https://shopify.dev/docs/api/admin-graphql/2025-04/scalars/ID) required ### Arguments The ID of the fulfillment. * tracking​Info​Input [Fulfillment​Tracking​Input!](https://shopify.dev/docs/api/admin-graphql/2025-04/input-objects/FulfillmentTrackingInput) required The tracking input for the mutation, including tracking URL, number, and company. * notify​Customer [Boolean](https://shopify.dev/docs/api/admin-graphql/2025-04/scalars/Boolean) Whether the customer will be notified of this update and future updates for the fulfillment. If this field is left blank, then notifications won't be sent to the customer when the fulfillment is updated. *** ### Deprecated mutations * [fulfillment​Create​V2](https://shopify.dev/docs/api/admin-graphql/2025-04/mutations/fulfillmentCreateV2) mutation Deprecated * fulfillment [Fulfillment​V2Input!](https://shopify.dev/docs/api/admin-graphql/2025-04/input-objects/FulfillmentV2Input) required ### Arguments The input fields used to create a fulfillment from fulfillment orders. * message [String](https://shopify.dev/docs/api/admin-graphql/2025-04/scalars/String) An optional message for the fulfillment request. *** * [fulfillment​Tracking​Info​Update​V2](https://shopify.dev/docs/api/admin-graphql/2025-04/mutations/fulfillmentTrackingInfoUpdateV2) mutation Deprecated * fulfillment​Id [ID!](https://shopify.dev/docs/api/admin-graphql/2025-04/scalars/ID) required ### Arguments The ID of the fulfillment. * tracking​Info​Input [Fulfillment​Tracking​Input!](https://shopify.dev/docs/api/admin-graphql/2025-04/input-objects/FulfillmentTrackingInput) required The tracking input for the mutation, including tracking URL, number, and company. * notify​Customer [Boolean](https://shopify.dev/docs/api/admin-graphql/2025-04/scalars/Boolean) Whether the customer will be notified of this update and future updates for the fulfillment. If this field is left blank, then notifications won't be sent to the customer when the fulfillment is updated. *** *** ## <\~> Fulfillment Mutations ### Mutated by * <\~>[fulfillment​Cancel](https://shopify.dev/docs/api/admin-graphql/2025-04/mutations/fulfillmentCancel) * <\~>[fulfillment​Create](https://shopify.dev/docs/api/admin-graphql/2025-04/mutations/fulfillmentCreate) * <\~>[fulfillment​Tracking​Info​Update](https://shopify.dev/docs/api/admin-graphql/2025-04/mutations/fulfillmentTrackingInfoUpdate) *** ## Interfaces * * [Legacy​Interoperability](https://shopify.dev/docs/api/admin-graphql/2025-04/interfaces/LegacyInteroperability) interface * [Node](https://shopify.dev/docs/api/admin-graphql/2025-04/interfaces/Node) interface *** ## ||-Fulfillment Implements ### Implements * ||-[Legacy​Interoperability](https://shopify.dev/docs/api/admin-graphql/2025-04/interfaces/LegacyInteroperability) * ||-[Node](https://shopify.dev/docs/api/admin-graphql/2025-04/interfaces/Node)