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

## Test case -- Success -- Retrieve additional Addresses for a Client {#test-case--success--retrieve-additional-addresses-for-a-client}

This test case describes retrieving addresses for a specified client stored in the CMS.

**Sample request**

`GET /clients/40000/addresses`

**Sample response**

`200`

```JSON
{
  "clientAddresses": [
    {
        "addressType": "PIN",
        "enabled": true,
        "addressLine1": "Mrs. Alice Smith Apartment",
        "addressLine2": "1c 213",
        "addressLine3": "Derrick Street",
        "addressLine4": "2nd floor",
        "city": "Boston",
        "country": "USA",
        "email": "johndoe@example.com",
        "firstName": "John",
        "lastName": "Doe",
        "postalCode": "02130",
        "state": "MA"
    },
    {
        "addressType": "STMT",
        "enabled": true,
        "addressLine1": "Mrs. Alice Smith Apartment",
        "addressLine2": "1c 213",
        "addressLine3": "Derrick Street",
        "addressLine4": "2nd floor",
        "city": "Boston",
        "country": "USA",
        "email": "johndoe@example.com",
        "firstName": "John",
        "lastName": "Doe",
        "postalCode": "02130",
        "state": "MA"
    }
  ]
}
```

## Test case -- Success -- No additional Addresses for a Client {#test-case--success--no-additional-addresses-for-a-client}

This test case describes retrieving a list of additional addresses for a specified client that does not have any additional addresses stored in the CMS.

For this test case, use the following information in the request:

| Path parameter | Available value |
|----------------|-----------------|
| `client_id`    | 45001           |

**Sample request**

`GET /clients/45001/addresses`

**Sample response**

`200`

```JSON
{
  "clientAddresses":[]
}
```

## Test case -- Success -- Retrieve Addresses for a Contract {#test-case--success--retrieve-addresses-for-a-contract}

This test case describes retrieving addresses for a specified contract (account contract or card contract) stored in the CMS.

**Sample request**

`GET /contracts/70001/addresses`

**Sample response**

`200`

```JSON
{
  "contractAddresses": [
    {
        "addressType": "PIN",
        "enabled": true,
        "addressLine1": "Mrs. Alice Smith Apartment",
        "addressLine2": "1c 213",
        "addressLine3": "Derrick Street",
        "addressLine4": "2nd floor",
        "city": "Boston",
        "country": "USA",
        "email": "johndoe@example.com",
        "firstName": "John",
        "lastName": "Doe",
        "postalCode": "02130",
        "state": "MA"
    }
  ]
}
```

## Test case -- Success -- No Addresses for a Contract {#test-case--success--no-addresses-for-a-contract}

This test case describes retrieving a list of addresses for a specified contract (account contract or card contract) that does not have any addresses stored in the CMS.

For this test case, use the following information in the request:

| Path parameter | Available value |
|----------------|-----------------|
| `contract_id`  | 45001           |

**Sample request**

`GET /contracts/45001/addresses`

**Sample response**

`200`

```JSON
{
  "contractAddresses": []
}
```