Listar faturas

Lista invoices em ordem decrescente de criação. Use invoices para acompanhar ciclos de assinatura, criações de assinatura (inclusive trial) e cobranças avulsas. Compras avulsas diretas não aparecem aqui — esse fluxo está em Payment Intent. Cada item pode trazer hosted_invoice_url, uma URL ativa da página pública daquela invoice.

Filtros

string

Filtra por customer (cus_*).

string

Filtra por subscription (sub_*).

string

Filtra pela tentativa de pagamento atual (pi_*).

string

Filtra por status.

Valor	Descrição
`draft`	Rascunho, ainda fora da cobrança automática.
`open`	Em aberto e pronta para pagamento.
`paid`	Liquidada.
`uncollectible`	Marcada como incobrável.
`void`	Cancelada.

string

Filtra invoices criadas a partir de uma data ISO 8601.

string

Filtra invoices criadas depois de uma data ISO 8601.

string

Filtra invoices criadas até uma data ISO 8601, inclusive.

string

Filtra invoices criadas antes de uma data ISO 8601.

integer

Quantidade de itens, de 1 a 100.

string

Cursor para a próxima página.

string

Cursor para a página anterior.

curl -X GET "https://api.chargefy.io/v1/invoices?customer=cus_NL7SAy821HQwiGb3&limit=10" \
  -H "Authorization: Bearer {{API_KEY}}"

200

{
  "object": "list",
  "data": [
    {
      "id": "inv_cMW1DHq1oGFcUfoK",
      "object": "invoice",
      "allow_late_payment": true,
      "amount_credit_balance_applied": 0,
      "amount_discount": 0,
      "amount_due": 9990,
      "amount_due_now": 9990,
      "amount_paid": 9990,
      "amount_remaining": 0,
      "amount_subtotal": 9990,
      "amount_tax": 0,
      "amount_total": 9990,
      "attempt_count": 1,
      "billing_reason": "subscription_cycle",
      "collection_method": "charge_automatically",
      "created_at": "2026-05-19T18:00:00Z",
      "currency": "brl",
      "customer": "cus_NL7SAy821HQwiGb3",
      "customer_billing_address": {
        "city": "São Paulo",
        "country": "BR",
        "line1": "Av. Paulista, 1000",
        "line2": "Conjunto 101",
        "postal_code": "01310-100",
        "state": "SP"
      },
      "customer_billing_name": "Cliente Exemplo",
      "customer_document": "12345678901",
      "customer_document_type": "cpf",
      "customer_email": "nome@email.com",
      "customer_name": "Cliente Exemplo",
      "default_payment_method": "pm_56sgSuggX74hGkR1",
      "description": "Assinatura Plano Pro - Maio/2026",
      "due_date": "2026-05-19T12:00:00Z",
      "ending_balance": 0,
      "hosted_invoice_url": "https://billing.chargefy.io/invoice/ilink_8Pz6wKf3tVn2Qa9LmXr4Bc7D",
      "interest": {
        "percent_per_month": 1
      },
      "interest_amount": null,
      "invoice_pdf_url": "https://billing.chargefy.io/invoice/inv_cMW1DHq1oGFcUfoK.pdf",
      "late_fee": {
        "type": "fixed",
        "value": 200
      },
      "late_fee_amount": null,
      "latest_charge": "ch_YLAX7y9xpdnnHs7S",
      "line_items": [
        {
          "id": "ili_SSe73bFEhfy5DLYp",
          "object": "invoice_line_item",
          "amount_discount": 0,
          "amount_subtotal": 9990,
          "amount_tax": 0,
          "amount_total": 9990,
          "currency": "brl",
          "description": "Plano mensal",
          "discountable": true,
          "metadata": {},
          "period_end": "2026-06-19T18:00:00Z",
          "period_start": "2026-05-19T18:00:00Z",
          "position": 0,
          "price": "price_R8Yymx8bwuf8f65g",
          "price_data": null,
          "product": "prod_3NrExw6f92a2AeEF",
          "proration": false,
          "proration_details": {},
          "quantity": 1,
          "recurring_interval": "month",
          "recurring_interval_count": 1,
          "subscription_item": "si_BoDFDEJUEWFxQ2Ft",
          "unit_amount": 9990
        }
      ],
      "livemode": true,
      "marked_uncollectible_at": null,
      "metadata": {},
      "next_payment_attempt": null,
      "number": "K7M2-0001",
      "paid_at": "2026-05-19T18:01:02Z",
      "payment_intent": "pi_w3psdq2U7ZHU2GtY",
      "payment_method_types": [
        "credit_card"
      ],
      "starting_balance": 0,
      "statement_descriptor": "PLANO PRO",
      "status": "paid",
      "subscription": "sub_tDTN4ziEVhdHw5vN",
      "updated_at": "2026-05-19T18:01:02Z",
      "voided_at": null
    }
  ],
  "has_more": false,
  "url": "/v1/invoices"
}

Erros comuns

400

{
  "error": {
    "code": "invalid_request",
    "message": "limit must be between 1 and 100.",
    "param": "limit",
    "type": "invalid_request_error"
  }
}

401

{
  "error": {
    "code": "authentication_failed",
    "message": "Invalid API key provided.",
    "type": "authentication_error"
  }
}

Fundamentos da API

Objetos de sistema

Webhooks e eventos

SDKs

MCP

Filtros

Erros comuns

​Filtros

​Erros comuns

Filtros

Erros comuns