Buscar en preferencias

Encuentra toda la información de las preferencias generadas a través de filtros específicos o por un rango de fechas determinado. Solo se traerán los datos de los últimos 90 días (3 meses). Si deseas buscar datos más antiguos, utiliza el GET de "Obtener preferencia".

GET

https://api.mercadopago.com/checkout/preferences/search
Request parameters
Header
Authorization
string

REQUERIDO

Access Token obtenido a través del panel de desarrollador. Obligatorio ser enviado en todas las solicitudes.
Query
sponsor_id
string
ID numérico único para identificar al sponsor. Se utiliza para identificar en qué plataforma se inició el flujo de pago.
external_reference
string
Referencia que puedes sincronizar con tu sistema de pagos.
site_id
string
ID del site.
marketplace
string
ID del Marketplace.
Response parameters
elements
array
Elements
next_offset
number
Campo numérico utilizado para paginar la respuesta.
total
number
total
Errores

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?limit=2'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-1*********685765-12*********1b4332e5c*********e077d7679*********664' \
    
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": "MLA",
      "sponsor_id": 0
    }
  ],
  "next_offset": 1,
  "total": 1
}