# Get address This endpoint allows you to retrieve a specific address from a customer. You must send the customer ID and the address ID in the path. In case of success, the request will return a response with status 200 containing the address data. **GET** `/v1/customers/{id}/addresses/{address_id}` ## Request parameters ### Path - `id` (string, required) Customer ID. - `address_id` (string, required) Address ID. ## Response parameters - `id` (string, optional) Address ID. - `phone` (string, optional) Phone number associated with the address. - `name` (string, optional) Address name/label. - `floor` (string, optional) Floor number. - `apartment` (string, optional) Apartment identifier. - `street_name` (string, optional) Street name. Max length: 255. ASCII only (no accents, e.g. no ñ, ã, é). - `street_number` (number, optional) Street number. - `zip_code` (string, optional) Postal code of the address. Max length: 255. Alphanumeric only: A-Z, a-z, 0-9, hyphen, underscore. No spaces or accents. - `city` (object, optional) City information. - `city.id` (string, optional) City ID. - `city.name` (string, optional) City name. - `state` (object, optional) State information. - `state.id` (string, optional) State ID. - `state.name` (string, optional) State name. - `country` (object, optional) Country information. - `country.id` (string, optional) Country ID. - `country.name` (string, optional) Country name. - `neighborhood` (object, optional) Neighborhood information. - `neighborhood.id` (string, optional) Neighborhood ID. - `neighborhood.name` (string, optional) Neighborhood name. - `municipality` (object, optional) Municipality information. - `municipality.id` (string, optional) Municipality ID. - `municipality.name` (string, optional) Municipality name. - `comments` (string, optional) Additional information about the address. - `date_created` (string, optional) Address creation date. - `date_last_updated` (string, optional) Last modified date. - `normalized` (boolean, optional) Whether the address is normalized. - `live_mode` (boolean, optional) Whether the address is in sandbox or production mode. ## Errors | Status | Error | Description | | ------- | ------- | ----------- | | 400 | 100 | The credentials are required. Provide a valid access token in the Authorization header. | | 400 | validation_error | Validation error. One or more fields failed validation. Check the request body and ensure all required fields are correctly formatted. | | 401 | unauthorized | Unauthorized access. The provided access token is invalid or expired. Verify your credentials and try again. | | 404 | not_found | The requested resource was not found. Verify that the customer ID and address ID are correct and that the address exists. | | 500 | internal_error | Internal server error. Please try again later or contact support if the issue persists. | ## Request example ### cURL ```bash curl -X GET \ 'https://api.mercadopago.com/v1/customers/{id}/addresses/{address_id}' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer ' ``` ## Response example ```json { "id": "1162600213", "phone": "string", "name": "string", "floor": "string", "apartment": "string", "street_name": "Rua Exemplo", "street_number": 0, "zip_code": "06233-903", "city": { "id": "BR-SP-44", "name": "Osasco" }, "state": { "id": "BR-SP", "name": "SP" }, "country": { "id": "BR", "name": "Brasil" }, "neighborhood": { "id": "string", "name": "Bonfim" }, "municipality": { "id": "string", "name": "string" }, "comments": "string", "date_created": "2021-03-16T15:45:17.000-04:00", "date_last_updated": "string", "normalized": false, "live_mode": true } ```