/v1/customers/:id

BASE URI https://api.mercadopago.com/v1/customers/{id}

HTTP Request

curl

 curl -X GET \
  'https://api.mercadopago.com/v1/customers/000000001-sT93QZFAsfxU9P5?access_token=ACCESS_TOKEN_ENV' 

Request Params

ParameterTypeDescription
id String Identificador de cliente.
email String Email del cliente.
first_name String Nombre del cliente.
last_name String Apellido del cliente.
phone Object Teléfono del cliente.
area_code String Código de área.
number String Número de teléfono.
identification Object Información sobre la identificación del cliente.
type String Tipo de identificación.
number String Número de identificación.
default_address String Dirección por defecto del cliente.
address Object Información sobre la dirección por defecto del cliente.
id String Identificador de la dirección del cliente.
zip_code String Código postal.
street_name String Calle.
street_number String Número.
date_registered Date(ISO_8601) Fecha de registro del cliente.
description String Descripción del cliente.
date_created Date(ISO_8601) Fecha de creación del cliente.
date_last_updated Date(ISO_8601) Última fecha de actualización.
metadata Object Metadata del cliente.
default_card String Tarjeta por defecto del cliente.
cards Object Tarjetas del cliente.
id String Identificador de tarjeta.
customer_id String Identificador de cliente.
expiration_month Integer Mes de expiración de la tarjeta.
expiration_year Integer Año de expiración de la tarjeta.
first_six_digits String Primeros seis dígitos de la tarjeta.
last_four_digits String Últimos cuatro dígitos de la tarjeta.
payment_method Object Información de los medios de pago.
id String Identificador del medio de pago.
name String Nombre del medio de pago.
payment_type_id String Tipo del medio de pago.
thumbnail String Thumbnail del medio de pago.
secure_thumbnail String Secure thumbnail del medio de pago.
security_code Object Información del código de seguridad.
length Integer Longitud del código de seguridad.
card_location String Ubicación del código de seguridad en la tarjeta.
issuer Object Información del emisor.
id Integer Identificador del emisor.
name String Nombre del emisor.
cardholder Object Información del dueño de la tarjeta.
name Integer Nombre.
identification Integer Información de la identificación.
number Integer Número de indentificación.
subtype String Subtipo de identificación.
type String Tipo de identificación.
date_created Date(ISO_8601) Fecha de creación de la tarjeta.
date_last_updated Date(ISO_8601) Última fecha de actualización de la tarjeta.
addresses Object List Dirección del cliente.
id String Identificador de la dirección.
phone String Número de teléfono.
name String Nombre.
floor String Piso.
apartment String Apartmento.
street_name String Calle.
street_number Number Número.
zip_code String Código postal.
city Object Información de la ciudad.
id String Identificador de la ciudad.
name String Nombre de la ciudad.
state Object Información de la provincia.
id String Identificador de la provincia.
name String Nombre de la provincia.
country Object Información del país.
id String Identificador del país.
name String Nombre del país.
neighborhood Object Información del barrio.
id String Identificador del barrio.
name String Nombre del barrio.
municipality Object Información de la municipalidad.
id String Identificador de la municipalidad.
name String Nombre de la municipalidad.
comments String Información adicional.
date_created String Fecha de creación de la dirección.
live_mode Boolean Indica si los clientes se crean en el entorno de sandbox o producción.

HTTP Response

json

 {
    "id": "000000001-sT93QZFAsfxU9P5",
    "email": "bruno@gmail.com",
    "first_name": "Bruce",
    "last_name": "Wayne",
    "phone": {
        "area_code": "023",
        "number": "12345678"
    },
    "identification": {
        "type": "DNI",
        "number": "12345678"
    },
    "address": {
        "id": null,
        "zip_code": "SG1 2AX",
        "street_name": "Old Knebworth Ln",
        "street_number": null
    },
    "date_registered": null,
    "description": "Lorem Ipsum",
    "date_created": "2018-02-20T00:00:00.000-04:00",
    "date_last_updated": null,
    "metadata": {},
    "default_card": null,
    "default_address": null,
    "cards": [],
    "addresses": [],
    "live_mode": false
} 

Error Codes

CodeDescription
400 BAD_REQUEST
100 Las credenciales son requeridas.
101 El cliente ya existe.
102 missing customer id.
103 El parámetro debe ser un objeto
104 La longitud del parámetro es muy grande.
105 El identificador de cliente es inválido.
106 El formato de email es inválido.
107 first_name inválido.
108 last_name inválido.
109 phone.area_code inválido.
110 phone.number inválido.
111 identification.type inválido.
112 identification.number inválido.
113 address.zip_code inválido.
114 address.street_name inválido.
115 date_registered format inválido.
116 description inválido.
117 metadata inválido.
118 El body debe ser un objeto JSON.
119 La tarjeta es requerida.
120 Tarjeta no encontrada.
121 La tarjeta es inválida.
122 card data inválida.
123 payment_method_id es requerido.
124 issuer_id es requerido.
125 Parámetros inválidos.
126 Parámetro inválido. No se puede actualizar el email.
127 Parámetro inválido. No se puede resolver el medio de pago de la tarjeta, revisa payment_method_id y issuer_id.
128 El formato de email es inválido. Usa 'test_payer_[0-9]{1,10}@testuser.com'.
129 El cliente llego al máximo permitido de tarjetas.
140 Dueño de tarjeta inválido.
150 Usuarios inválidos involucrados.
200 Formato de rango inválido (range=:date_parameter:after::date_from,before::date_to).
201 El atributo del rango debe pertenecer a la entidad date.
202 Parámetro 'after' inválido. Debería ser date[iso_8601].
203 Parámetro 'before' inválido. Debería ser date[iso_8601].
204 Formato inválido de filtros.
205 Formato de consulta inválido.
206 Los atributos a ordenar deben perstenecer a la entidad 'customer'.
207 El orden del filtro debe ser 'asc' o 'desc'.
208 Formato inválido del parámetro 'sort'.
401 UNAUTHORIZED
unauthorized No autorizado.
404 NOT_FOUND
not_found not_found.

La búsqueda no arrojó ningún resultado.

Verifica la la ortografía de los términos de búsqueda o prueba con otras palabras clave.