Fulfillment object

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.

Required access

read_orders access scope.

On this page

• Connections
• Fields
• Types that return Fulfillment
• Mutations for Fulfillment
• Implements
• Samples

Connections

• events ([FulfillmentEventConnection!](https://shopify.dev/docs/admin-api/graphql/reference/shipping-and-fulfillment/fulfillmentevent))
  The history of events associated with this fulfillment.

• fulfillmentLineItems ([FulfillmentLineItemConnection!](https://shopify.dev/docs/admin-api/graphql/reference/shipping-and-fulfillment/fulfillmentlineitem))
  List of the fulfillment’s line items.

• fulfillmentOrders ([FulfillmentOrderConnection!](https://shopify.dev/docs/admin-api/graphql/reference/shipping-and-fulfillment/fulfillmentorder))
  A list of fulfillment orders for the fulfillment.

• Fields

• createdAt ([DateTime!](https://shopify.dev/docs/admin-api/graphql/reference/scalar#datetime-2021-01))
  The date and time when the fulfillment was created.
• deliveredAt ([DateTime](https://shopify.dev/docs/admin-api/graphql/reference/scalar#datetime-2021-01))
  The date that this fulfillment was delivered.
• displayStatus ([FulfillmentDisplayStatus](https://shopify.dev/docs/admin-api/graphql/reference/shipping-and-fulfillment/fulfillmentdisplaystatus))
  Human readable display status for this fulfillment.
• estimatedDeliveryAt ([DateTime](https://shopify.dev/docs/admin-api/graphql/reference/scalar#datetime-2021-01))
  The estimated date that this fulfillment will arrive.
• id ([ID!](https://shopify.dev/docs/admin-api/graphql/reference/scalar#id-2021-01))
  Globally unique identifier.
• inTransitAt ([DateTime](https://shopify.dev/docs/admin-api/graphql/reference/scalar#datetime-2021-01))
  The date and time when the fulfillment went into transit.
• legacyResourceId ([UnsignedInt64!](https://shopify.dev/docs/admin-api/graphql/reference/scalar#unsignedint64-2021-01))
  The ID of the corresponding resource in the REST Admin API.
• location ([Location](https://shopify.dev/docs/admin-api/graphql/reference/store-properties/location))
  The location that the fulfillment was processed at.
• name ([String!](https://shopify.dev/docs/admin-api/graphql/reference/scalar#string-2021-01))
  Human readable reference identifier for this fulfillment.
• order ([Order!](https://shopify.dev/docs/admin-api/graphql/reference/orders/order))
  The order for which the fulfillment was created.
• requiresShipping ([Boolean!](https://shopify.dev/docs/admin-api/graphql/reference/scalar#boolean-2021-01))
  Whether any of the line items in the fulfillment require shipping.
• service ([FulfillmentService](https://shopify.dev/docs/admin-api/graphql/reference/shipping-and-fulfillment/fulfillmentservice))
  Fulfillment service associated with the fulfillment.
• status ([FulfillmentStatus!](https://shopify.dev/docs/admin-api/graphql/reference/shipping-and-fulfillment/fulfillmentstatus))
  The status of the fulfillment.
• totalQuantity ([Int!](https://shopify.dev/docs/admin-api/graphql/reference/scalar#int-2021-01))
  Sum of all line item quantities for the fulfillment.
• trackingInfo ([[FulfillmentTrackingInfo!]!](https://shopify.dev/docs/admin-api/graphql/reference/shipping-and-fulfillment/fulfillmenttrackinginfo))
  Tracking information associated with the fulfillment, such as the tracking company, tracking number, and tracking URL.

• updatedAt ([DateTime!](https://shopify.dev/docs/admin-api/graphql/reference/scalar#datetime-2021-01))
  The date and time when the fulfillment was last modified.

Types that return Fulfillment

• [FulfillmentOrder.fulfillments](https://shopify.dev/docs/admin-api/graphql/reference/shipping-and-fulfillment/fulfillmentorder#fulfillments-2021-01)
• [Order.fulfillments](https://shopify.dev/docs/admin-api/graphql/reference/orders/order#fulfillments-2021-01)
• [QueryRoot.fulfillment](https://shopify.dev/docs/admin-api/graphql/reference/common-objects/queryroot#fulfillment-2021-01)

Mutations for Fulfillment

• fulfillmentCancel
  Cancels a fulfillment.
• fulfillmentCreateV2
  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.

Implements

• [LegacyInteroperability](https://shopify.dev/docs/admin-api/graphql/reference/common-objects/legacyinteroperability)
• [Node](https://shopify.dev/docs/admin-api/graphql/reference/common-objects/node)

An auto-generated type for paginating through multiple Fulfillments.

On this page

• Fields

Fields

• edges ([[FulfillmentEdge!]!](https://shopify.dev/docs/admin-api/graphql/reference/shipping-and-fulfillment/fulfillment))
  A list of edges.
• pageInfo ([PageInfo!](https://shopify.dev/docs/admin-api/graphql/reference/pageinfo))
  Information to aid in pagination.

An auto-generated type which holds one Fulfillment and a cursor during pagination.

On this page

• Fields
• Types that return FulfillmentEdge

Fields

• cursor ([String!](https://shopify.dev/docs/admin-api/graphql/reference/scalar#string-2021-01))
  A cursor for use in pagination.
• node ([Fulfillment!](https://shopify.dev/docs/admin-api/graphql/reference/shipping-and-fulfillment/fulfillment))
  The item at the end of FulfillmentEdge.

Types that return FulfillmentEdge

• [FulfillmentConnection.edges](https://shopify.dev/docs/admin-api/graphql/reference/shipping-and-fulfillment/fulfillment#edges-2021-01)