Listar endereços

Este endpoint permite obter a lista de todos os endereços associados a um cliente específico. É necessário enviar o ID do cliente no path. Em caso de sucesso, a requisição retornará uma resposta com o status 200 contendo o array de endereços.

GET

https://api.mercadopago.com/v1/customers/{id}/addresses
Request parameters
Header
Authorization
string

OBRIGATÓRIO

Access Token obtido através do painel de desenvolvedores. Obrigatório ser enviado em todas as requisições.
Path
id
string

OBRIGATÓRIO

Identificador de cliente.
Response parameters
id
string
Identificador do endereço.
phone
string
Número de telefone associado ao endereço.
name
string
Nome/rótulo do endereço.
floor
string
Número do andar.
Erros

400Erro de requisição.

100

As credenciais são obrigatórias. Forneça um token de acesso válido no cabeçalho Authorization.

401Erro. Access Token não autorizado.

unauthorized

Acesso não autorizado. O token de acesso fornecido é inválido ou expirado. Verifique suas credenciais e tente novamente.

404Erro. Recurso solicitado não encontrado.

not_found

O recurso solicitado não foi encontrado. Verifique se o ID do cliente e o ID do endereço estão corretos e se o endereço existe.

500Erro genérico.

internal_error

Erro interno do servidor. Tente novamente mais tarde ou entre em contato com o suporte se o problema persistir.

Request
curl -X GET \
    'https://api.mercadopago.com/v1/customers/{id}/addresses'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-5*********956537-12*********ff1a3d36d*********47e7b9985*********770' \
    
Response
[
  {
    "id": "1162600213",
    "street_name": "Rua Exemplo",
    "zip_code": "11300",
    "city": {
      "id": "BR-SP-44",
      "name": "Montevideo"
    },
    "state": {
      "id": "BR-SP",
      "name": "Montevideo"
    },
    "country": {
      "id": "UY",
      "name": "Uruguay"
    },
    "neighborhood": {
      "name": "Pocitos"
    },
    "municipality": {},
    "date_created": "2021-03-16T15:45:17.000-04:00",
    "live_mode": true,
    "verifications": {}
  }
]