Home
Documentation
Resources
Certifications
Community
Search in invoices - Invoices - Mercado Pago Developers

Intelligent search powered by OpenAI 

Search invoices

GET

https://api.mercadopago.com/authorized_payments/search
Search the invoices of a subscriptions by different parameters. You can search by subscription, payment or customer ID.
Request's parameters
PATH
id
number

REQUIRED

Unique ID that identifies a invoice.
preapproval_id
string

REQUIRED

Unique subscription ID to find related invoices.
payment_id
number

REQUIRED

Unique payment ID to find related invoice.
payer_id
number

REQUIRED

Unique payer ID to find your related invoices.
Response parameters
paging
object
Information for pagination of search results.
results
array
Errors

400Error

400

Bad-request

401Error

401

Unauthorized

500Error

500

Error

Request
curl -X GET \
    'https://api.mercadopago.com/authorized_payments/search'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer TEST-2151*********762-03031*********750b665b7*********4dac477-1*********' \
    
Sample answer
{
  "paging": {
    "offset": 0,
    "limit": 20,
    "total": 100
  },
  "results": [
    {
      "id": 6114264375,
      "type": "scheduled",
      "date_created": "2022-01-01T11:12:25.892-04:00",
      "last_modified": "2022-01-01T11:12:25.892-04:00",
      "preapproval_id": "2c938084726fca480172750000000000",
      "reason": "Yoga classes",
      "external_reference": 23546246234,
      "currency_id": "ARS",
      "transaction_amount": 10,
      "debit_date": "2022-01-01T11:12:25.892-04:00",
      "retry_attempt": 4,
      "status": "scheduled",
      "summarized": "pending",
      "payment": {
        "id": 19951521071,
        "status": "approved",
        "status_detail": "accredited"
      }
    }
  ]
}