Listar direcciones

Este endpoint permite obtener la lista de todas las direcciones asociadas a un cliente específico. Debes enviar el ID del cliente en el path. En caso de éxito, la solicitud devolverá una respuesta con el estado 200 que contiene el array de direcciones.

GET

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

REQUERIDO

Access Token obtenido a través del panel de desarrollador. Obligatorio ser enviado en todas las solicitudes.
Path
id
string

REQUERIDO

Identificador de cliente.
Response parameters
id
string
Identificador de la dirección.
phone
string
Número de teléfono asociado a la dirección.
name
string
Nombre/etiqueta de la dirección.
floor
string
Número de piso.
Errors

400Error de solicitud.

100

Las credenciales son obligatorias. Proporciona un token de acceso válido en el encabezado Authorization.

401Error. Access Token no autorizado.

unauthorized

Acceso no autorizado. El token de acceso proporcionado es inválido o ha expirado. Verifica tus credenciales e intenta nuevamente.

404Error. Recurso solicitado no encontrado.

not_found

El recurso solicitado no fue encontrado. Verifica que el ID del cliente y el ID de la dirección sean correctos y que la dirección exista.

500Error genérico.

internal_error

Error interno del servidor. Intenta nuevamente más tarde o contacta con soporte si el problema persiste.

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": {}
  }
]