/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 E-mail do cliente.
first_name String (a-zA-Z) Nome do cliente.
last_name String (a-zA-Z) Sobrenome do cliente.
phone Object Telefone do cliente.
area_code String Código de área.
number String Número de telefone.
identification Object Informações sobre a identificação do cliente.
type String Tipo de identificação.
number String Número de identificação.
default_address String Endereço por defeito do cliente.
address Object Informação sobre o endereço padrão do cliente.
id String Identificador do endereço do cliente.
zip_code String Código postal.
street_name String Rua.
street_number String O Número.
date_registered Date(ISO_8601) Data de registo do cliente.
description String Descrição do cliente.
date_created Date(ISO_8601) Data de criação do cliente.
date_last_updated Date(ISO_8601) Última data de atualização.
metadata Object Metadata do cliente.
default_card String Cartão padrão do cliente.
cards Object Cartões do cliente.
id String Identificador de cartão.
customer_id String Identificador de cliente.
expiration_month Integer Mês de validade do cartão.
expiration_year Integer Ano de validade do cartão.
first_six_digits String Os primeiros seis dígitos do cartão.
last_four_digits String Últimos quatro dígitos do cartão.
payment_method Object Informação dos meios de pagamento.
id String Id do meio de pagamento.
name String Nome do meio de pagamento.
payment_type_id String Tipo do meio de pagamento.
thumbnail String Thumbnail do meio de pagamento.
secure_thumbnail String Secure thumbnail do meio de pagamento.
security_code Object Informação do código de segurança.
length Integer Comprimento do código de segurança.
card_location String Localização do código de segurança no cartão.
issuer Object Informações do emitente.
id Integer Id do remetente.
name String Nome do emitente.
cardholder Object Informações do dono do cartão.
name Integer O nome.
identification Integer Informação de identificação.
number Integer Número de identificação.
subtype String Subtipo de identificação.
type String Tipo de identificação.
date_created Date(ISO_8601) Data de criação do cartão.
date_last_updated Date(ISO_8601) Última data de atualização do cartão.
addresses Object List Endereço do cliente.
id String Identificador de endereço.
phone String Número de telefone.
name String O nome.
floor String Apartamento.
apartment String Apartamento.
street_name String Rua.
street_number Number O Número.
zip_code String Código postal.
city Object Informações da cidade.
id String Identificador da cidade.
name String Nome da cidade.
state Object Informação da província.
id String Identificador da província.
name String Nome da província.
country Object Informação do país.
id String Identificador do país.
name String Nome do país.
neighborhood Object Informação do bairro.
id String Id do bairro.
name String Nome do bairro.
municipality Object Informação da prefeitura.
id String Id do município.
name String Nome do município.
comments String Informações adicionais.
date_created String Data de criação da diretoria.
live_mode Boolean Indica se os comentários são criados no ambiente de sandbox ou produção.

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 the credentials are required.
101 the customer already exist.
102 missing customer id.
103 parameter must be an object
104 parameter length is too large.
105 the customer id is invalid.
106 the email format is invalid.
107 the first_name is invalid.
108 the last_name is invalid.
109 the phone.area_code is invalid.
110 the phone.number is invalid.
111 the identification.type is invalid.
112 the identification.number is invalid.
113 the address.zip_code is invalid.
114 the address.street_name is invalid.
115 the date_registered format is invalid.
116 the description is invalid.
117 the metadata is invalid.
118 the body must be a Json Object.
119 the card is required.
120 card not found.
121 the card is invalid.
122 the card data is invalid.
123 the payment_method_id is required.
124 the issuer_id is required.
125 invalid parameters.
126 invalid parameter. You cannot update the email.
127 invalid parameter. Cannot resolve the payment method of card, check the payment_method_id and issuer_id.
128 the email format is invalid. Use 'test_payer_[0-9]{1,10}@testuser.com'.
129 the customer has reached the maximum allowed number of cards.
140 invalid card owner.
150 invalid users involved.
200 invalid range format (range=:date_parameter:after::date_from,before::date_to).
201 range attribute must belong to date entity.
202 invalid 'after' parameter. It should be date[iso_8601].
203 invalid 'before' parameter. It should be date[iso_8601].
204 invalid filters format.
205 invalid query format.
206 attributes to sort must belong to 'customer' entity.
207 order filter must be 'asc' or 'desc'.
208 invalid 'sort' parameter format.
401 UNAUTHORIZED
unauthorized unauthorized.
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.