---
title: "Get all shopper addresses"
method: GET
path: "/v1/shoppers/me/addresses"
tags: ["Addresses"]
---

# Get all shopper addresses

`GET /v1/shoppers/me/addresses`

Retrieve all addresses configured for a shopper, such as home and work addresses.
If you need to access a billing or shipping address, use the methods available in the Carts API.

## Query parameters

- `token` string
- `expand` string
- `fields` string

## Response `200`

Successful response.

- union
  - DefaultShopperAddresses
    - `addresses` object
      - `uri` string
      - `address` DefaultShopperAddress[]
        - `uri` string
        - `nickName` string
        - `isDefault` string
  - ExpandedShopperAddresses
    - `addresses` object
      - `uri` string
      - `address` ExpandedAddress[]
        - `uri` string
        - `id` integer
        - `nickName` string — The nick name of the address.
        - `isDefault` string
        - `firstName` string — The shopper's first name.
        - `lastName` string
        - `companyName` string — Company Name
        - `line1` string — The first line of the address.
        - `line2` string
        - `line3` string — The third line of the address.
        - `city` string — City or town.
        - `countrySubdivision` string — State/County/Province/Region.
        - `postalCode` string — ZIP or postal code.
        - `country` string — A two-letter (ISO 3166-2) country code. See https://en.wikipedia.org/wiki/ISO_3166-2 for a complete list of country codes.
        - `countryName` string — Country.
        - `phoneNumber` string — The shopper's phone number.
        - `countyName` string — County.
        - `phoneticFirstName` string — The shopper's Japanese Katakana first name. (Optional, usually for Japanese locale.)
        - `phoneticLastName` string — The shopper's Japanese Katakana last name. (Optional, usually for Japanese locale.)
        - `division` string — The shopper's company departmant name. (Optional, usually for Japanese locale.)

## Other responses

- `401` — * Invalid Token

---

[API](https://skmtc.net/digitalriver/apis/commerce-api-suite-shopper-apis.md) · [All operations](https://skmtc.net/digitalriver/apis/commerce-api-suite-shopper-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/digitalriver/commerce-api-suite-shopper-apis/revisions/4b69392f93b9/schema)