List Fulfillment Orders

//native

/**

 * List Fulfillment Orders

 * List fulfillment orders across the shop (filtered with Shopify's search syntax, e.g. `status:open`), or the fulfillment orders of one order when order_id is set. Each one shows its status, holds, supported actions and line item ids (the first 10). Returns one page; pass pageInfo.endCursor as after for the next. Needs the read_merchant_managed_fulfillment_orders scope (plus read_assigned/read_third_party for other locations).

 */

export async function main(

  auth: RT.Shopify,

  order_id: string | undefined,

  query: string | undefined,

  include_closed: boolean | undefined,

  sort_key: "UPDATED_AT" | "ID" | undefined,

  reverse: boolean | undefined,

  first: number | undefined,

  after: string | undefined

) {

  const response = await fetch(

    `https://${auth.store_name}.myshopify.com/admin/api/2026-10/graphql.json`,

    {

      method: "POST",

      headers: {

        "X-Shopify-Access-Token": auth.token,

        "Content-Type": "application/json",

        Accept: "application/json",

      },

      body: JSON.stringify(

        order_id

          ? {

              query: `query ($id: ID!, $first: Int!, $after: String, $query: String, $reverse: Boolean) { order(id: $id) { fulfillmentOrders(first: $first, after: $after, query: $query, reverse: $reverse) { nodes { id status requestStatus orderId orderName createdAt updatedAt fulfillAt fulfillBy assignedLocation { name location { id } } fulfillmentHolds { id reason reasonNotes handle } supportedActions { action } lineItems(first: 10) { nodes { id sku productTitle variantTitle totalQuantity remainingQuantity lineItem { id } } } } pageInfo { hasNextPage endCursor } } } }`,

              variables: {

                id: order_id.startsWith("gid://")

                  ? order_id

                  : `gid://shopify/Order/${order_id}`,

                first: first || 50,

                after: after || undefined,

                query: query || undefined,

                reverse: reverse || undefined,

              },

            }

          : {

              query: `query ($first: Int!, $after: String, $query: String, $includeClosed: Boolean, $sortKey: FulfillmentOrderSortKeys, $reverse: Boolean) { fulfillmentOrders(first: $first, after: $after, query: $query, includeClosed: $includeClosed, sortKey: $sortKey, reverse: $reverse) { nodes { id status requestStatus orderId orderName createdAt updatedAt fulfillAt fulfillBy assignedLocation { name location { id } } fulfillmentHolds { id reason reasonNotes handle } supportedActions { action } lineItems(first: 10) { nodes { id sku productTitle variantTitle totalQuantity remainingQuantity lineItem { id } } } } pageInfo { hasNextPage endCursor } } }`,

              variables: {

                first: first || 50,

                after: after || undefined,

                query: query || undefined,

                includeClosed: include_closed || undefined,

                sortKey: sort_key || undefined,

                reverse: reverse || undefined,

              },

            }

      ),

    }

  )

  if (!response.ok) {

    throw new Error(`${response.status} ${await response.text()}`)

  }

  const { data, errors } = await response.json()

  if (errors) {

    throw new Error(JSON.stringify(errors))

  }

  if (order_id) {

    if (!data.order) {

      throw new Error(`Order ${order_id} not found`)

    }

    return data.order.fulfillmentOrders

  }

  return data.fulfillmentOrders

}