Inicio
Documentação
Recursos
Certificações
Comunidade

Recursos

Confira as atualizações das nossas soluções e do funcionamento do sistema ou peça suporte técnico.

Comunidade

Fique por dentro das últimas novidades, peça ajuda a outros integradores e compartilhe seu conhecimento.

Buscar em preferências - Preferências - Mercado Pago Developers
Buscar em preferências

GET

https://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".
Parâmetros de requisição
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.
MLA: Mercado Libre Argentina
MLB: Mercado Libre Brasil
MLC: Mercado Libre Chile
Ver mais
marketplace
string
ID do Marketplace.
Parâmetros de resposta
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

Requisição
curl -X GET \
    'https://api.mercadopago.com/checkout/preferences/search'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer TEST-7719*********832-03141*********ec9309854*********f1e54b5-1*********' \
    
Resposta de exemplo
{
  "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": "MLA",
      "sponsor_id": 0
    }
  ],
  "next_offset": 1,
  "total": 1
}