Choose a version:

fulfillment

query

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.

Retrieves a Fulfillment by its ID. A fulfillment is a record that the merchant has completed their work required for one or more line items in an Order. It includes tracking information, LineItem objects, and the status of the fulfillment.

Use this query to track the progress of shipped items, view tracking details, or check fulfillment events for example when a package is out for delivery or delivered.

Anchor to Arguments

Arguments

Anchor to idid •ID! required: The ID of the Fulfillment to return.

Was this section helpful?

Anchor to Possible returnsPossible returns

Anchor to FulfillmentFulfillment

•Fulfillment

A shipment of one or more items from an Order. Tracks which LineItem objects ship, their quantities, and the shipment's tracking information.

Includes tracking details such as the carrier, tracking numbers, and URLs. The fulfillment connects to both the original order and any associated FulfillmentOrder objects. FulfillmentEvent objects record milestones throughout the shipment lifecycle, from creation through delivery.

Multiple fulfillments can exist for a single order when items either ship separately or from different locations.

Anchor to createdAtcreatedAt

•DateTime!

non-null

The date and time when the fulfillment was created.

Anchor to deliveredAtdeliveredAt

•DateTime

The date that this fulfillment was delivered.

Anchor to displayStatusdisplayStatus

•FulfillmentDisplayStatus

Human readable display status for this fulfillment.

Anchor to estimatedDeliveryAtestimatedDeliveryAt

•DateTime

The estimated date that this fulfillment will arrive.

Anchor to eventsevents

•FulfillmentEventConnection!

non-null

The history of events associated with this fulfillment.

Arguments

Anchor to firstfirst

•Int

The first n elements from the paginated list.

Anchor to afterafter

•String

The elements that come after the specified cursor.

Anchor to lastlast

•Int

The last n elements from the paginated list.

Anchor to beforebefore

•String

The elements that come before the specified cursor.

Anchor to reversereverse

•Boolean

Default:false

Reverse the order of the underlying list.

Anchor to sortKeysortKey

•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.

Anchor to fulfillmentLineItemsfulfillmentLineItems

•FulfillmentLineItemConnection!

non-null

List of the fulfillment's line items.

Anchor to firstfirst •Int: The first n elements from the paginated list.
Anchor to afterafter •String: The elements that come after the specified cursor.
Anchor to lastlast •Int: The last n elements from the paginated list.
Anchor to beforebefore •String: The elements that come before the specified cursor.
Anchor to reversereverse •Boolean Default:false: Reverse the order of the underlying list.

Anchor to fulfillmentOrdersfulfillmentOrders

•FulfillmentOrderConnection!

non-null

A paginated list of fulfillment orders for the fulfillment.

Anchor to firstfirst •Int: The first n elements from the paginated list.
Anchor to afterafter •String: The elements that come after the specified cursor.
Anchor to lastlast •Int: The last n elements from the paginated list.
Anchor to beforebefore •String: The elements that come before the specified cursor.
Anchor to reversereverse •Boolean Default:false: Reverse the order of the underlying list.

Anchor to idid

•ID!

non-null

A globally-unique ID.

Anchor to inTransitAtinTransitAt

•DateTime

The date and time when the fulfillment went into transit.

Anchor to legacyResourceIdlegacyResourceId

•UnsignedInt64!

non-null

The ID of the corresponding resource in the REST Admin API.

Anchor to locationlocation

•Location

The location that the fulfillment was processed at.

Anchor to namename

•String!

non-null

Human readable reference identifier for this fulfillment.

Anchor to orderorder

•Order!

non-null

The order for which the fulfillment was created.

Anchor to originAddressoriginAddress

•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 object instead.

Anchor to requiresShippingrequiresShipping

•Boolean!

non-null

Whether any of the line items in the fulfillment require shipping.

Anchor to serviceservice

•FulfillmentService

Fulfillment service associated with the fulfillment.

Anchor to statusstatus

•FulfillmentStatus!

non-null

The status of the fulfillment.

Anchor to totalQuantitytotalQuantity

•Int!

non-null

Sum of all line item quantities for the fulfillment.

Anchor to trackingInfotrackingInfo

•[FulfillmentTrackingInfo!]!

non-null

Tracking information associated with the fulfillment, such as the tracking company, tracking number, and tracking URL.

Anchor to firstfirst •Int: Truncate the array result to this size.

Anchor to updatedAtupdatedAt

•DateTime!

non-null

The date and time when the fulfillment was last modified.

Was this section helpful?

Examples

Receive a single Fulfillment

Query

query FulfillmentShow($id: ID!) {
  fulfillment(id: $id) {
    fulfillmentLineItems(first: 10) {
      edges {
        node {
          id
          lineItem {
            title
            variant {
              id
            }
          }
          quantity
          originalTotalSet {
            shopMoney {
              amount
              currencyCode
            }
          }
        }
      }
    }
    status
    estimatedDeliveryAt
    location {
      id
      legacyResourceId
    }
    service {
      handle
    }
    trackingInfo(first: 10) {
      company
      number
      url
    }
    originAddress {
      address1
      address2
      city
      countryCode
      provinceCode
      zip
    }
  }
}

Variables

{
  "id": "gid://shopify/Fulfillment/237894043"
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-01/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "query FulfillmentShow($id: ID!) { fulfillment(id: $id) { fulfillmentLineItems(first: 10) { edges { node { id lineItem { title variant { id } } quantity originalTotalSet { shopMoney { amount currencyCode } } } } } status estimatedDeliveryAt location { id legacyResourceId } service { handle } trackingInfo(first: 10) { company number url } originAddress { address1 address2 city countryCode provinceCode zip } } }",
 "variables": {
    "id": "gid://shopify/Fulfillment/237894043"
  }
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  query FulfillmentShow($id: ID!) {
    fulfillment(id: $id) {
      fulfillmentLineItems(first: 10) {
        edges {
          node {
            id
            lineItem {
              title
              variant {
                id
              }
            }
            quantity
            originalTotalSet {
              shopMoney {
                amount
                currencyCode
              }
            }
          }
        }
      }
      status
      estimatedDeliveryAt
      location {
        id
        legacyResourceId
      }
      service {
        handle
      }
      trackingInfo(first: 10) {
        company
        number
        url
      }
      originAddress {
        address1
        address2
        city
        countryCode
        provinceCode
        zip
      }
    }
  }`,
  {
    variables: {
        "id": "gid://shopify/Fulfillment/237894043"
    },
  },
  );
  const json = await response.json();
  return json.data;
}

Ruby

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 FulfillmentShow($id: ID!) {
    fulfillment(id: $id) {
      fulfillmentLineItems(first: 10) {
        edges {
          node {
            id
            lineItem {
              title
              variant {
                id
              }
            }
            quantity
            originalTotalSet {
              shopMoney {
                amount
                currencyCode
              }
            }
          }
        }
      }
      status
      estimatedDeliveryAt
      location {
        id
        legacyResourceId
      }
      service {
        handle
      }
      trackingInfo(first: 10) {
        company
        number
        url
      }
      originAddress {
        address1
        address2
        city
        countryCode
        provinceCode
        zip
      }
    }
  }
QUERY

variables = {
  "id": "gid://shopify/Fulfillment/237894043"
}

response = client.query(query: query, variables: variables)

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `query FulfillmentShow($id: ID!) {
      fulfillment(id: $id) {
        fulfillmentLineItems(first: 10) {
          edges {
            node {
              id
              lineItem {
                title
                variant {
                  id
                }
              }
              quantity
              originalTotalSet {
                shopMoney {
                  amount
                  currencyCode
                }
              }
            }
          }
        }
        status
        estimatedDeliveryAt
        location {
          id
          legacyResourceId
        }
        service {
          handle
        }
        trackingInfo(first: 10) {
          company
          number
          url
        }
        originAddress {
          address1
          address2
          city
          countryCode
          provinceCode
          zip
        }
      }
    }`,
    "variables": {
        "id": "gid://shopify/Fulfillment/237894043"
    },
  },
});

Response

{
  "fulfillment": {
    "fulfillmentLineItems": {
      "edges": [
        {
          "node": {
            "id": "gid://shopify/FulfillmentLineItem/761422146",
            "lineItem": {
              "title": "Draft",
              "variant": {
                "id": "gid://shopify/ProductVariant/43729076"
              }
            },
            "quantity": 2,
            "originalTotalSet": {
              "shopMoney": {
                "amount": "20.0",
                "currencyCode": "USD"
              }
            }
          }
        }
      ]
    },
    "status": "SUCCESS",
    "estimatedDeliveryAt": null,
    "location": {
      "id": "gid://shopify/Location/124656943",
      "legacyResourceId": "124656943"
    },
    "service": {
      "handle": "manual"
    },
    "trackingInfo": [
      {
        "company": "UPS",
        "number": "1Z1234512345123456",
        "url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z1234512345123456"
      }
    ],
    "originAddress": {
      "address1": "150 Elgin St",
      "address2": null,
      "city": "Ottawa",
      "countryCode": "CA",
      "provinceCode": "ON",
      "zip": "K2P 1L4"
    }
  }
}

Retrieves a list of fulfillment events for a specific fulfillment

Query

query FulfillmentEventList($id: ID!) {
  fulfillment(id: $id) {
    events(first: 10) {
      edges {
        node {
          happenedAt
          status
        }
      }
    }
  }
}

Variables

{
  "id": "gid://shopify/Fulfillment/237894043"
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-01/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "query FulfillmentEventList($id: ID!) { fulfillment(id: $id) { events(first: 10) { edges { node { happenedAt status } } } } }",
 "variables": {
    "id": "gid://shopify/Fulfillment/237894043"
  }
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  query FulfillmentEventList($id: ID!) {
    fulfillment(id: $id) {
      events(first: 10) {
        edges {
          node {
            happenedAt
            status
          }
        }
      }
    }
  }`,
  {
    variables: {
        "id": "gid://shopify/Fulfillment/237894043"
    },
  },
  );
  const json = await response.json();
  return json.data;
}

Ruby

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 FulfillmentEventList($id: ID!) {
    fulfillment(id: $id) {
      events(first: 10) {
        edges {
          node {
            happenedAt
            status
          }
        }
      }
    }
  }
QUERY

variables = {
  "id": "gid://shopify/Fulfillment/237894043"
}

response = client.query(query: query, variables: variables)

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `query FulfillmentEventList($id: ID!) {
      fulfillment(id: $id) {
        events(first: 10) {
          edges {
            node {
              happenedAt
              status
            }
          }
        }
      }
    }`,
    "variables": {
        "id": "gid://shopify/Fulfillment/237894043"
    },
  },
});

Response

{
  "fulfillment": {
    "events": {
      "edges": [
        {
          "node": {
            "happenedAt": "2016-05-02T11:00:00Z",
            "status": "LABEL_PURCHASED"
          }
        },
        {
          "node": {
            "happenedAt": "2016-05-03T11:00:00Z",
            "status": "OUT_FOR_DELIVERY"
          }
        }
      ]
    }
  }
}

Examples

Open in GraphiQL

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {

const { admin } = await authenticate.admin(request);

const response = await admin.graphql(

`#graphql

query FulfillmentEventList($id: ID!) {

fulfillment(id: $id) {

events(first: 10) {

edges {

node {

happenedAt

status

}

}`,

{

variables: {

"id": "gid://shopify/Fulfillment/237894043"

);

const json = await response.json();

return json.data;

}

GQL

query FulfillmentEventList($id: ID!) {
  fulfillment(id: $id) {
    events(first: 10) {
      edges {
        node {
          happenedAt
          status
        }
      }
    }
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-01/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "query FulfillmentEventList($id: ID!) { fulfillment(id: $id) { events(first: 10) { edges { node { happenedAt status } } } } }",
 "variables": {
    "id": "gid://shopify/Fulfillment/237894043"
  }
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  query FulfillmentEventList($id: ID!) {
    fulfillment(id: $id) {
      events(first: 10) {
        edges {
          node {
            happenedAt
            status
          }
        }
      }
    }
  }`,
  {
    variables: {
        "id": "gid://shopify/Fulfillment/237894043"
    },
  },
  );
  const json = await response.json();
  return json.data;
}

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `query FulfillmentEventList($id: ID!) {
      fulfillment(id: $id) {
        events(first: 10) {
          edges {
            node {
              happenedAt
              status
            }
          }
        }
      }
    }`,
    "variables": {
        "id": "gid://shopify/Fulfillment/237894043"
    },
  },
});

Ruby

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 FulfillmentEventList($id: ID!) {
    fulfillment(id: $id) {
      events(first: 10) {
        edges {
          node {
            happenedAt
            status
          }
        }
      }
    }
  }
QUERY

variables = {
  "id": "gid://shopify/Fulfillment/237894043"
}

response = client.query(query: query, variables: variables)

Input variables

JSON

{

"id": "gid://shopify/Fulfillment/237894043"

}

Response

JSON

{

"fulfillment": {

"events": {

"edges": [

{

"node": {

"happenedAt": "2016-05-02T11:00:00Z",

"status": "LABEL_PURCHASED"

}

{

"node": {

"happenedAt": "2016-05-03T11:00:00Z",

"status": "OUT_FOR_DELIVERY"

}

]

}