Home
Documentation
Resources
Partners
Community

Partners

Discover our program for agencies or developers that offer integration services and sellers who want to hire them.

Community

Get the latest news, ask others for help and share your knowledge.

Search preferences - Preferences - Mercado Pago Developers

Intelligent search powered by OpenAI 

Search preferences

GET

https://api.mercadopago.com/checkout/preferences/search
Find all the information related to generated preferences using specific filters or a specific date range..
Request's parameters
QUERY
sponsor_id
string
Unique numeric ID to identify the sponsor. It is used to identify what platform the checkout flow was initiated in.
external_reference
string
Reference you can synchronize with your payment system.
site_id
string
The site id.
MLA: Mercado Libre Argentina
MLB: Mercado Libre Brasil
MLC: Mercado Libre Chile
View more
marketplace
string
Marketplace ID.
Response parameters
elements
array
Elements
next_offset
number
Numeric field used to paginate the response.
total
number
total
Errors

400Error

ds_search_query

invalid query.

401Error

invalid_token

invalid_token.

invalid_caller_id

invalid caller_id

Request
curl -X GET \
    'https://api.mercadopago.com/checkout/preferences/search'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer TEST-7434*********159-03141*********cee51edf8*********f94f589-1*********' \
    
Sample answer
{
  "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
}