Buscar em faturas - Faturas - Mercado Pago Developers
Buscar em faturas

Pesquise as faturas de uma assinatura por diferentes parâmetros. Você pode pesquisar por assinatura, pagamento ou Customer ID.

GET

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

OBRIGATÓRIO

Access Token obtido através do painel de desenvolvedores. Obrigatório ser enviado em todas as requisições.
Path
id
number

OBRIGATÓRIO

ID único que identifica uma fatura.
preapproval_id
string

OBRIGATÓRIO

ID único de assinatura para encontrar faturas relacionadas.
payment_id
number

OBRIGATÓRIO

ID único do pagamento para encontrar faturas relacionadas.
payer_id
number

OBRIGATÓRIO

ID único do pagamento para encontrar suas notas relacionadas.
Response parameters
paging
object
Informações para paginação dos resultados da pesquisa.
results
array
Erros

400Erro

400

Bad-request

401Erro

401

Unauthorized

500Erro

500

Error

Request
curl -X GET \
    'https://api.mercadopago.com/authorized_payments/search'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-8*********932064-12*********edf6d3c99*********2236c703f*********668' \
    
Response
{
  "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"
      }
    }
  ]
}