Recursos para IA
Buscar em preferênciashttps://api.mercadopago.com/checkout/preferences/search
Encontre todas as informações das preferências geradas através de filtros específicos ou por uma faixa de datas específica. Somente serão trazidos os dados dos últimos 90 dias (3 meses). Caso queira buscar dados mais antigos, utilize o GET de "Obter preferência".
GET
Request parameters
Header
Authorization
string
OBRIGATÓRIO
Access Token obtido através do painel de desenvolvedores. Obrigatório ser enviado em todas as requisições.
Query
sponsor_id
string
ID numérico exclusivo para identificar o sponsor. É usado para identificar em qual plataforma o fluxo de pagamento foi iniciado.
external_reference
string
Referência que pode sincronizar com seu sistema de pagamentos.
site_id
string
ID do site.
marketplace
string
ID do Marketplace.
Response parameters
elements
array
Elements
next_offset
number
Campo numérico usado para paginar a resposta.
total
number
total
Erros
400Erro
ds_search_query
invalid query.
401Erro
invalid_token
invalid_token.
invalid_caller_id
invalid caller_id
Request
curl -X GET \
'https://api.mercadopago.com/checkout/preferences/search?limit=2'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-4*********782856-12*********f202ca494*********f0baa4bb3*********648' \
curl -X GET \
'https://api.mercadopago.com/checkout/preferences/search?limit=2'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-4*********782856-12*********f202ca494*********f0baa4bb3*********648' \
curl -X GET \
'https://api.mercadopago.com/checkout/preferences/search?limit=2'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-4*********782856-12*********f202ca494*********f0baa4bb3*********648' \
curl -X GET \
'https://api.mercadopago.com/checkout/preferences/search?limit=2'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-4*********782856-12*********f202ca494*********f0baa4bb3*********648' \
Response
{
"elements": [
{
"id": "202809963-a2201f8d-11cb-443f-adf6-de5a42eed67d",
"client_id": "6295877106812064",
"collector_id": 202809963,
"date_created": "2018-02-02T19:18:51.150Z",
"expiration_date_from": "2022-11-17T09:37:52.000-04:00",
"expiration_date_to": "2022-11-17T10:37:52.000-05:00",
"items": [
{}
],
"marketplace": "NONE",
"site_id": "MCO",
"sponsor_id": 0
}
],
"next_offset": 1,
"total": 1
}