**Version: 202601**

# List addresses

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

Retrieve a list of all address with pagination.

## Request

**Path Parameters**

- `customer_id` string (required)

  Customer ID

**Query Parameters**

- `cursor` string

  Cursor for pagination
- `page_size` int32

  Number of records per page. The default value is 10, and the maximum allowed value is 250
- `page` int32

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

## Responses

**200**

OK

**application/json**

**Schema | Example**

**Schema**

- `code` string

  error code
- `message` string

  error message
- `data` object

  - `addresses` object[]

    Array containing address objects

    *   Array \[

    - `id` string

      Address ID
    - `customer_id` string

      ID of the customer this address belongs to
    - `first_name` string

      First name of the consignee
    - `last_name` string

      Last name of the consignee
    - `company` string

      Company name
    - `city` string

      City of the address
    - `province` string

      Province or state of the address
    - `country` string

      Country name of the address
    - `zip` string

      Postal or ZIP code
    - `province_code` string

      Province code
    - `country_code` string

      ISO country code
    - `gender` string

      Gender of the consignee
    - `phone` string

      Phone number associated with the address
    - `phone_area_code` string

      Area code of the phone number
    - `area` string

      Area or region of the address
    - `email` string

      Email associated with the address
    - `name` string

      Full name of the consignee
    - `address1` string

      Primary street address
    - `address2` string

      Secondary street address
    - `country_name` string

      Full name of the country
    - `default` boolean

      Indicates if this is the default address
    *   \]
  - `cursor` string

    The cursor for the next page of results
  - `has_more` boolean

    Whether there are more records

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