Home
Documentation
Resources
Certifications
Community
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-2151*********762-03031*********750b665b7*********4dac477-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
}