**版本：202601**

# 查询履约列表

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

分页返回订单的履约列表。

## 请求

**Path参数**

- `order_id` string (required)

  订单 ID

**Query参数**

- `cursor` string

  分页游标
- `page_size` int32

  每页记录数
- `page` int32

  页码（从 1 开始），与 cursor 互斥
- `created_at_min` string

  筛选创建时间不早于该时间点的履约；ISO-8601 格式（例如 `2023-01-01T00:00:00Z`）
- `created_at_max` string

  筛选创建时间不晚于该时间点的履约；ISO-8601 格式（例如 `2023-01-01T00:00:00Z`）
- `updated_at_min` string

  筛选最后更新时间不早于该时间点的履约；ISO-8601 格式（例如 `2023-01-01T00:00:00Z`）
- `updated_at_max` string

  筛选最后更新时间不晚于该时间点的履约；ISO-8601 格式（例如 `2023-01-01T00:00:00Z`）

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `fulfillments` object[]

    履约列表

    *   Array \[

    - `id` string

      履约 ID
    - `order_id` string

      订单 ID
    - `status` string

      物流单状态：

      *   `pending`: 待发货
      *   `shipped`: 已发货
      *   `finished`: 已完成
      *   `cancelled`: 已取消
    - `created_at` string

      创建时间（ISO-8601 格式）
    - `updated_at` string

      最后更新时间（ISO-8601 格式）
    - `tracking_company` string

      物流商
    - `tracking_number` string

      运单号
    - `tracking_company_code` string

      物流商编码
    - `line_items` object[]

      本次履约包含的订单商品项列表

      *   Array \[

      - `id` string

        订单商品项 ID
      - `product_id` string

        商品 ID
      - `product_title` string

        已购商品名称
      - `variant_id` string

        子款式 ID
      - `variant_title` string

        子款式标题，例如 `Blue, Size M`
      - `quantity` uint32

        已购该商品的数量
      - `note` string

        订单商品项的商品备注
      - `image` object

        商品图片

        - `src` string

          图片来源 URL
        - `width` int32

          图片宽度（像素）
        - `height` int32

          图片高度（像素）
        - `alt` string

          图片替代文本
      - `price` string

        售价
      - `compare_at_price` string

        划线价
      - `total_price` string

        总价
      - `fulfillment_status` string

        订单商品项的履约状态，例如 `fulfilled`（已履约）、`unfulfilled`（未履约）；详见履约状态文档
      - `sku` string

        SKU
      - `weight` string

        商品重量
      - `weight_unit` string

        商品重量的计量单位，例如 `kg`、`lbs`
      - `vendor` string

        商品供应商
      - `product_url` string

        商品页面 URL
      - `created_at` string

        创建时间（ISO-8601 格式）
      - `updated_at` string

        最后更新时间（ISO-8601 格式）
      - `options` object[]

        订单商品项关联的商品款式属性列表

        *   Array \[

        - `name` string

          商品款式属性名称
        - `value` string

          商品款式属性值
        *   \]
      - `product_slug` string

        商品的 URL 友好标识
      - `taxable` boolean

        是否需要纳税
      - `requires_shipping` boolean

        订单商品项是否需要物流
      - `spu` string

        标准商品单元（SPU）
      - `product_tags` string

        商品标签
      - `refund_quantity_total` uint32

        退款数量
      - `ship_quantity` uint32

        发货数量
      - `custom` boolean

        是否为自定义商品项
      - `trunk_price` string

        主干价格
      - `discount_applications` string

        订单商品项运费的折扣应用数量
      - `tax_price` string

        订单商品项的税费
      - `duty_price` string

        关税费用
      - `payment_discount_price` string

        应用于订单商品项的支付折扣金额
      - `custom_properties` object

        订单商品项的自定义属性（如尺码、颜色等），JSON 格式
      *   \]
    - `tracking_url` string

      物流链接
    - `phone_number` string

      电话号码
    *   \]
  - `cursor` string

    下一页游标
  - `has_more` boolean

    是否有更多记录

```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
  }
}
```