Referência da API

Listar invoices da assinatura

Lista paginada das Invoices geradas por essa Subscription, ordenadas por `createdAt DESC`. Valores em centavos.

GET/v2/subscriptions/:id/invoices

Autenticação

HTTP Basic Auth. Envie sua secret key no header:

Authorization: Basic {base64(secret:SUA_SECRET_KEY)}

Parâmetros

idstring (path, UUID)obrigatório

UUID da Subscription.

Exemplo: sub_abc123-...

pagenumber (query, 0-indexed)opcional

Página. Default: 0.

Exemplo: 0

limitnumber (query)opcional

Por página. Default: 20. Máximo: 100.

Exemplo: 20

Respostas

200

Lista paginada de Invoices da Subscription.

JSON

{
  "result": [
    {
      "id": "inv_111aaa",
      "status": "PAID",
      "description": "Plano Pro Mensal - Ciclo 3",
      "amount": 4900,
      "amountPaid": 4900,
      "dueDate": "2026-08-01T00:00:00.000Z",
      "paidAt": "2026-07-29T15:23:00.000Z",
      "canceledAt": null,
      "createdAt": "2026-07-25T00:00:00.000Z"
    }
  ],
  "totalCount": 3
}

404

Subscription não encontrada.

JSON

{ "status": 404, "error": "Subscription nao encontrada" }

Exemplos

cURL

curl -X GET "https://api.pagnovo.com/v2/subscriptions/sub_abc123-.../invoices" \
  -H "Authorization: Basic $(echo -n 'secret:SUA_SECRET_KEY' | base64)"