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

# Get all shopper addresses

`GET /v1/shoppers/me/addresses`

## Request

- Base URL: `https://api.digitalriver.com`
- URL: `https://api.digitalriver.com/v1/shoppers/me/addresses`
- Auth: none declared

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.dev/digitalriver/apis/commerce-api-suite-shopper-apis.md) - [All operations](https://skmtc.dev/digitalriver/apis/commerce-api-suite-shopper-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/digitalriver/apis/commerce-api-suite-shopper-apis/revisions/4b69392f93b9?raw)