dinzo.api

Listar faturas do cartão

Lista as faturas por ciclo de um cartão de crédito dentro da janela informada em from/to (YYYY-MM-DD; janela máxima de 366 dias). Cada fatura traz datas de início de ciclo, fechamento e vencimento, valor, situação (aberta/fechada/vencida/paga) e indicadores de estimativa. Responde 400 quando a conta não é cartão de crédito e 404 quando não existe.

GET
/v1/cards/{id}/bills

Authorization

bearerAuth
AuthorizationBearer <token>

Chave de API no cabeçalho Authorization: Bearer dz_live_...

In: header

Path Parameters

id*string

Query Parameters

from*string

Início da janela (YYYY-MM-DD).

to*string

Fim da janela (YYYY-MM-DD); máx. 366 dias.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/v1/cards/string/bills?from=string&to=string"
{  "card_id": "459af7c0-c917-4a18-9b3f-c6b4739b7a08",  "bills": [    {      "cycle_start_date": "2026-06-04",      "close_date": "2026-07-03",      "due_date": "2026-07-10",      "amount": 2431.88,      "amount_is_estimate": false,      "status": "paga",      "projected_bill_id": null,      "settled_payment_ids": [        "txn_a1b2c3d4"      ]    },    {      "cycle_start_date": "2026-07-04",      "close_date": "2026-08-03",      "due_date": "2026-08-10",      "amount": 1167.29,      "amount_is_estimate": false,      "status": "fechada",      "projected_bill_id": "mocked-bill:6307ee15-f5c2-4e11-aeb3-d728d8a99ec4:1754179200000",      "settled_payment_ids": []    },    {      "cycle_start_date": "2026-08-04",      "close_date": "2026-09-03",      "due_date": "2026-09-10",      "amount": 842.15,      "amount_is_estimate": true,      "status": "aberta",      "projected_bill_id": "mocked-bill:a12f1e74-b9d2-4e2e-922b-a1f4344db6fe:1756857600000",      "settled_payment_ids": []    }  ]}