Search for a customer/v1/customers/searchFind all customer information using specific filters.
GET
Request's parameters
emailstring
Localization: queryThe user e-mail for searchREQUIRED
Response parameters
paging
Localization: bodypagingobject
results
Localization: bodyresultsarray
Request
curl
curl -X GET \
'https://api.mercadopago.com/v1/customers/search?email=jhon@doe.com' \
-H 'Authorization: Bearer ACCESS_TOKEN_ENV'
Answer
json
{
"paging": {
"limit": 10,
"offset": 0,
"total": 1
},
"results": [
{
"address": {
"id": "1162600213",
"street_name": "Caetano Poli, 12",
"zip_code": "05187010"
},
"addresses": [
{}
],
"cards": [
{}
],
"date_created": "2017-05-05T04:00:00.000Z",
"date_last_updated": "2017-05-05T13:23:25.021Z",
"default_address": "1162600213",
"default_card": 1493990563105,
"email": "test@test.com",
"first_name": "Customer",
"id": "123456789-jxOV430go9fx2e",
"identification": {
"number": "19119119100",
"type": "CPF"
},
"last_name": "Tester",
"live_mode": true,
"metadata": {},
"phone": {
"area_code": "11",
"number": "987654321"
}
}
]
}
Errors
400bad_request
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
140
150
200
201
202
203
204
205
206
207
208
401bad_request
unauthorized
404bad_request
not_found
Was this information helpful?