# Retrieve Addresses
source: https://developer.mastercard.com/mastercard-processing-core/documentation/use-cases/data-management/query-cms-get-particular-data/retrieve-addresses/index.md

## Overview {#overview}

The use case describes how you retrieve a list of addresses assigned to the client or contract (card contract or account contract).

## Sequence diagram {#sequence-diagram}

Diagram retrieve-addresses

### Explanation {#explanation}

1. The server sends a `GET` request to the:
   * `/clients/{client_id}/addresses` endpoint to retrieve the addresses for the client
   * `/contracts/{contract_id}/addresses` endpoint to retrieve the addresses for the contract (account contract or card contract). The server must pass `accountContractId` or `cardContractId`, respectively, in place of `contract_id` in the path.
2. The API returns the addresses stored in the CMS for the client, account contract, or card contract depending on the endpoint used in the request. Refer to [Endpoints](https://developer.mastercard.com/mastercard-processing-core/documentation/use-cases/data-management/query-cms-get-particular-data/retrieve-addresses/index.md#endpoints) to check the complete list of data returned by the endpoint.

Refer to [Sandbox testing](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/data-management/query-cms-to-get-particular-data/retrieve-addresses/index.md) for information on how to execute the use case in the Sandbox environment.

## Endpoints {#endpoints}


API Reference: `GET /clients/{client_id}/addresses`


API Reference: `GET /contracts/{contract_id}/addresses`

<br />