**版本：202601**

# 查询地址列表

**GET** `/openapi/2026-01/customers/:customer_id/addresses`

分页返回地址列表。

## 请求

**Path参数**

- `customer_id` string (required)

  顾客 ID

**Query参数**

- `cursor` string

  分页游标
- `page_size` int32

  每页记录数
- `page` int32

  页码（从 1 开始），与 cursor 互斥

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `addresses` object[]

    地址列表

    *   Array \[

    - `id` string

      地址的唯一标识
    - `customer_id` string

      顾客 ID
    - `first_name` string

      收件人的名
    - `last_name` string

      收件人的姓
    - `company` string

      公司名称
    - `city` string

      地址所在城市
    - `province` string

      地址所在省份或州
    - `country` string

      地址所在国家名称
    - `zip` string

      邮政编码
    - `province_code` string

      省份代码
    - `country_code` string

      ISO 国家代码
    - `gender` string

      收件人的性别
    - `phone` string

      与地址关联的电话号码
    - `phone_area_code` string

      电话号码的区号
    - `area` string

      地址所在区域或地区
    - `email` string

      与地址关联的电子邮件
    - `name` string

      收件人的全名
    - `address1` string

      地址1
    - `address2` string

      地址2
    - `country_name` string

      国家全称
    - `default` boolean

      是否为默认地址
    *   \]
  - `cursor` string

    分页游标
  - `has_more` boolean

    是否有更多记录

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "addresses": [
      {
        "id": "string",
        "customer_id": "string",
        "first_name": "string",
        "last_name": "string",
        "company": "string",
        "city": "string",
        "province": "string",
        "country": "string",
        "zip": "string",
        "province_code": "string",
        "country_code": "string",
        "gender": "string",
        "phone": "string",
        "phone_area_code": "string",
        "area": "string",
        "email": "string",
        "name": "string",
        "address1": "string",
        "address2": "string",
        "country_name": "string",
        "default": true
      }
    ],
    "cursor": "string",
    "has_more": true
  }
}
```