Buscar en suscripcioneshttps://api.mercadopago.com/preapproval/search
Buscar suscripciones usando diferentes parámetros.
GET
Request parameters
Header
Authorization
Access Token obtenido a través del panel de desarrollador. Obligatorio ser enviado en todas las solicitudes.string
REQUERIDO
Path
q
Campo de búsqueda libre.string
payer_id
Customer ID único para encontrar suscripciones relacionadas.number
payer_email
Te permite buscar suscripciones registradas con este correo electrónico.string
preapproval_plan_id
Especifica un plan ID para filtrar los resultados de la búsqueda.string
Response parameters
paging
Información para paginación de resultados de búsqueda.object
results
La página de ítems. Esta será un array vacío si no hay resultados.array
Errors
400Error
400
Bad request
401Error
401
Unauthorized
500Error
500
Error
Request
curl -X GET \
'https://api.mercadopago.com/preapproval/search'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-5*********956537-12*********ff1a3d36d*********47e7b9985*********770' \
Response
{
"paging": {
"offset": 0,
"limit": 20,
"total": 100
},
"results": [
{
"id": "2c938084726fca480172750000000000",
"version": 0,
"application_id": 1234567812345678,
"collector_id": 100200300,
"preapproval_plan_id": "2c938084726fca480172750000000000",
"reason": "Yoga classes.",
"external_reference": 23546246234,
"back_url": "https://www.mercadopago.com.ar",
"init_point": "https://www.mercadopago.com.ar/subscriptions/checkout?preapproval_id=2c938084726fca480172750000000000",
"auto_recurring": {
"frequency": 1,
"frequency_type": "months",
"start_date": "2020-06-02T13:07:14.260Z",
"end_date": "2022-07-20T15:59:52.581Z",
"currency_id": "UYU",
"transaction_amount": "24.50",
"free_trial": {
"frequency": 1,
"frequency_type": "months"
}
},
"first_invoice_offset": 7,
"payer_id": 123123123,
"payer_first_name": "Valentina",
"payer_last_name": "Martínez",
"card_id": 123123123,
"payment_method_id": "visa",
"next_payment_date": "2022-01-01T11:12:25.892-04:00",
"date_created": "2022-01-01T11:12:25.892-04:00",
"last_modified": "2022-01-01T11:12:25.892-04:00",
"summarized": {
"quotas": 6,
"charged_quantity": 3,
"charged_amount": "24.50",
"pending_charge_quantity": 1,
"pending_charge_amount": 200,
"last_charged_date": "2022-01-01T11:12:25.892-04:00",
"last_charged_amount": 100,
"semaphore": "green"
},
"status": "pending"
}
]
}