Meu Dinheiro · API
Cartões

A fatura de todos os cartões num mês

GET
/cartoes/faturas

O resumo da fatura de cada cartão em uso que vence no mês, numa chamada só: "quanto vou pagar de cartão este mês". Sem mes, a fatura aberta de cada cartão. Os números são os de GET /cartoes/{id}/faturas/{mes}, sem os lançamentos; cartão cuja fatura do mês passa do horizonte de faturas futuras fica de fora.

Autenticação

accessToken
headerAuthorizationBearer <token>

Access token (mda_…) obtido em POST /auth/token. Vale 1 hora.

Parâmetros de consulta

mes?string

O mês do vencimento, AAAA-MM. Sem ele, a fatura aberta de cada cartão.

Padrão (regex)^\d{4}-(0[1-9]|1[0-2])$

Corpo da resposta

Uma linha por cartão.

application/json
  1. response
mes*|

O mês pedido, AAAA-MM; nulo quando cada linha é a fatura aberta do cartão.

Padrão (regex)^\d{4}-(0[1-9]|1[0-2])$
data*array<>
curl -X GET "https://example.com/cartoes/faturas"
{  "mes": "string",  "data": [    {      "cartao": {        "id": 0,        "nome": "string"      },      "moeda": "string",      "mes": "2026-08",      "vencimento": "2019-08-24",      "fechamento": "2019-08-24",      "status": "fechada",      "valor": -1840.32,      "pagamentos": 0,      "pagamentos_agendados": 0    }  ]}