**Version: 202601**

# List fulfillments

**GET** `/openapi/2026-01/orders/:order_id/fulfillments`

Retrieves a list of fulfillments for the order.

## Request

**Path Parameters**

- `order_id` string (required)

  Order ID

**Query Parameters**

- `cursor` string

  Cursor for pagination, use the cursor from the response to retrieve the next page
- `page_size` int32

  A limit on the number of objects to be returned. Ranges from 1 to 250. Default is 10
- `page` int32

  Page number (1-based). Mutually exclusive with cursor
- `created_at_min` string

  Filter fulfillments created at or after this date. ISO-8601 format, for example, "2023-01-01T00:00:00Z"
- `created_at_max` string

  Filter fulfillments created at or before this date. ISO-8601 format, for example, "2023-01-01T00:00:00Z"
- `updated_at_min` string

  Filter fulfillments updated at or after this date. ISO-8601 format, for example, "2023-01-01T00:00:00Z"
- `updated_at_max` string

  Filter fulfillments updated at or before this date. ISO-8601 format, for example, "2023-01-01T00:00:00Z"

## Responses

**200**

OK

**application/json**

**Schema | Example**

**Schema**

- `code` string

  error code
- `message` string

  error message
- `data` object

  - `fulfillments` object[]

    List of fulfillments

    *   Array \[

    - `id` string

      Fulfillment ID
    - `order_id` string

      Order's ID
    - `status` string

      Fulfillment status:

      *   `pending`: pending shipment
      *   `shipped`: shipped
      *   `finished`: finished
      *   `cancelled`: cancelled
    - `created_at` string

      Creation time, in ISO-8601 format
    - `updated_at` string

      Last update time, in ISO-8601 format
    - `tracking_company` string

      Logistics company
    - `tracking_number` string

      Tracking number
    - `tracking_company_code` string

      Logistics company code
    - `line_items` object[]

      Line items included in this fulfillment

      *   Array \[

      - `id` string

        Line item ID
      - `product_id` string

        Product associated with this line item ID
      - `product_title` string

        The name of the product purchased
      - `variant_id` string

        Specific variant of the product ID
      - `variant_title` string

        The title of the product variant, for example, "Blue, Size M"
      - `quantity` uint32

        The number of units of this product purchased
      - `note` string

        A note related to the product in this line item, added by the merchant or customer
      - `image` object

        Image

        - `src` string

          The source URL of the image
        - `width` int32

          The width of the image in pixels
        - `height` int32

          The height of the image in pixels
        - `alt` string

          Alt text for the image
      - `price` string

        Price
      - `compare_at_price` string

        Compare-at price
      - `total_price` string

        Total price
      - `fulfillment_status` string

        The fulfillment status of this line item. For example, "fulfilled", "unfulfilled". See Fulfillment Status
      - `sku` string

        Stock Keeping Unit (SKU) for the product variant, used for inventory tracking
      - `weight` string

        Weight of the product
      - `weight_unit` string

        Unit of measurement for the product weight. For example, "kg", "lbs"
      - `vendor` string

        The vendor or supplier of the product
      - `product_url` string

        The URL of the product page for customers
      - `created_at` string

        Creation time, in ISO-8601 format
      - `updated_at` string

        Last update time, in ISO-8601 format
      - `options` object[]

        Product option values (a.k.a. variant option values) associated with this line item

        *   Array \[

        - `name` string

          Option name
        - `value` string

          Option value
        *   \]
      - `product_slug` string

        URL-friendly identifier of the product
      - `taxable` boolean

        Whether the line item is taxable
      - `requires_shipping` boolean

        Whether this line item requires shipping
      - `spu` string

        Standard Product Unit (SPU)
      - `product_tags` string

        Product tags
      - `refund_quantity_total` uint32

        Refunded quantity for this line item
      - `ship_quantity` uint32

        Shipped quantity for this line item
      - `custom` boolean

        Whether the line item is a custom item
      - `trunk_price` string

        Trunk price
      - `discount_applications` string

        Number of discounts applied to the shipping for this line item
      - `tax_price` string

        Tax of the line item
      - `duty_price` string

        Duty cost
      - `payment_discount_price` string

        Price of payment discounts applied to the line item
      - `custom_properties` object

        Custom properties of the line item, such as size, color, etc. JSON format
      *   \]
    - `tracking_url` string

      Tracking URL
    - `phone_number` string

      Phone number
    *   \]
  - `cursor` string

    Cursor for the next page of results
  - `has_more` boolean

    Whether there are more records

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "fulfillments": [
      {
        "id": "string",
        "order_id": "string",
        "status": "string",
        "created_at": "string",
        "updated_at": "string",
        "tracking_company": "string",
        "tracking_number": "string",
        "tracking_company_code": "string",
        "line_items": [
          {
            "id": "string",
            "product_id": "string",
            "product_title": "string",
            "variant_id": "string",
            "variant_title": "string",
            "quantity": 0,
            "note": "string",
            "image": {
              "src": "string",
              "width": 0,
              "height": 0,
              "alt": "string"
            },
            "price": "string",
            "compare_at_price": "string",
            "total_price": "string",
            "fulfillment_status": "string",
            "sku": "string",
            "weight": "string",
            "weight_unit": "string",
            "vendor": "string",
            "product_url": "string",
            "created_at": "string",
            "updated_at": "string",
            "options": [
              {
                "name": "string",
                "value": "string"
              }
            ],
            "product_slug": "string",
            "taxable": true,
            "requires_shipping": true,
            "spu": "string",
            "product_tags": "string",
            "refund_quantity_total": 0,
            "ship_quantity": 0,
            "custom": true,
            "trunk_price": "string",
            "discount_applications": "string",
            "tax_price": "string",
            "duty_price": "string",
            "payment_discount_price": "string",
            "custom_properties": {}
          }
        ],
        "tracking_url": "string",
        "phone_number": "string"
      }
    ],
    "cursor": "string",
    "has_more": true
  }
}
```