Meu Dinheiro · API
Cartões

Uma fatura com os lançamentos

GET
/cartoes/{id}/faturas/{mes}

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.

Autenticação

accessToken
headerAuthorizationBearer <token>

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

Parâmetros de caminho

id*integer

O id do cartão (o mesmo da conta em /contas).

mes*string

O mês do vencimento.

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

Corpo da resposta

A fatura.

application/json
  1. response
mes*Mes

Mês no formato AAAA-MM.

Padrão (regex)^\d{4}-(0[1-9]|1[0-2])$
vencimento*string
Formatodate
fechamento*string
Formatodate
status*StatusFatura
Valores"fechada""aberta""futura"
valor*number

O saldo da fatura; negativo é o que se deve. Na fechada, o valor do fechamento; na aberta, o saldo da anterior mais os lançamentos, sem os pagamentos agendados.

pagamentos*number

Pagamentos confirmados lançados nesta fatura (o pagamento de uma fatura entra na seguinte).

pagamentos_agendados*number
cartao*|

O cadastro da linha; nulo para "sem" (sem centro, sem categoria…).

moeda*string
valor_fatura_anterior*|

O valor da fatura do mês anterior; nulo na futura.

despesas*number

Compras, com os estornos de receita.

receitas*number

Créditos, com os estornos de despesa.

transferencias*number

Transferências, sem os pagamentos recebidos.

total_lancamentos*number

despesas + receitas + transferencias.

total_fixo*number

Despesas recorrentes (fixas).

conciliado*number
nao_conciliado*number
limite_disponivel*|

Só na fatura aberta; o mesmo do cartão.

lancamentos*array<>
curl -X GET "https://example.com/cartoes/0/faturas/2026-08"
{  "mes": "2026-08",  "vencimento": "2019-08-24",  "fechamento": "2019-08-24",  "status": "fechada",  "valor": -1840.32,  "pagamentos": 0,  "pagamentos_agendados": 0,  "cartao": {    "id": 0,    "nome": "string"  },  "moeda": "string",  "valor_fatura_anterior": 0,  "despesas": 0,  "receitas": 0,  "transferencias": 0,  "total_lancamentos": 0,  "total_fixo": 0,  "conciliado": 0,  "nao_conciliado": 0,  "limite_disponivel": 0,  "lancamentos": [    {      "id": 0,      "data": "2019-08-24",      "vencimento": "2019-08-24",      "descricao": "string",      "valor": -89.9,      "tipo": "despesa",      "estorno": true,      "parcela": "string",      "conciliado": true,      "projetado": true,      "categoria": {        "id": 0,        "nome": "string"      },      "centro": {        "id": 0,        "nome": "string"      },      "contato": {        "id": 0,        "nome": "string"      },      "projeto": {        "id": 0,        "nome": "string"      },      "plastico": {        "id": 0,        "nome": "string"      },      "grupo_id": 0    }  ]}

As faturas do cartão, mês a mês GET

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.

As parcelas que ainda vão cair GET

As parcelas de compras parceladas nas faturas depois da aberta, como na tela Parcelas futuras.