As faturas do cartão, mês a mês
Um resumo por fatura, de inicio a fim: vencimento, situação, valor e pagamentos. Os meses
antes da fatura aberta só aparecem quando a fatura existe; da aberta em diante, todos — a futura
traz o que já foi lançado nela, inclusive parcelas e recorrências.
accessTokenAuthorizationBearer <token>Access token (mda_…) obtido em POST /auth/token. Vale 1 hora.
id*integerO id do cartão (o mesmo da conta em /contas).
inicio?stringO primeiro mês. Sem o parâmetro, 11 meses antes do fim.
^\d{4}-(0[1-9]|1[0-2])$fim?stringO último mês, até 36 depois do de inicio e da fatura aberta. Sem o parâmetro, o mês da fatura aberta.
^\d{4}-(0[1-9]|1[0-2])$O histórico.
application/json- response
cartao*|O cadastro da linha; nulo para "sem" (sem centro, sem categoria…).
moeda*stringinicio*MesMês no formato AAAA-MM.
^\d{4}-(0[1-9]|1[0-2])$fim*MesMês no formato AAAA-MM.
^\d{4}-(0[1-9]|1[0-2])$data*array<>curl -X GET "https://example.com/cartoes/0/faturas"{ "cartao": { "id": 0, "nome": "string" }, "moeda": "string", "inicio": "2026-08", "fim": "2026-08", "data": [ { "mes": "2026-08", "vencimento": "2019-08-24", "fechamento": "2019-08-24", "status": "fechada", "valor": -1840.32, "pagamentos": 0, "pagamentos_agendados": 0 } ]}Altera um cartão (todos os campos) PUT
Troca todos os campos do cartão (menos `valor_fatura_anterior`, opcional); para alterar só alguns, use `PATCH`. Exige o papel **Editor** ou um papel com permissão de editar Contas. Plásticos: com `id`, o existente (nome e status; o titular não se inativa); sem `id`, um novo. Plástico fora da lista fica como está, e adicional inativado sem lançamentos é excluído, como no app. Trocar o `proximo_vencimento` desloca as faturas abertas: no máximo um mês adiante, e para trás só se aquele mês não tem fatura fechada; adiante, com fatura fechada antiga, a fatura aberta é fechada.
Uma fatura com os lançamentos GET
A fatura que vence em `mes`, com o resumo da tela e todos os lançamentos (sem paginação). Mês sem fatura — antes do cartão, a primeira (que só guarda o saldo anterior ao cadastro) ou anterior à aberta que não existe — responde 404.