/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' \
-H 'Authorization: Bearer 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.