Um lançamento é uma receita ou despesa em uma conta (account_id) ou em um cartão (credit_card_id). Lançamentos de cartão são sempre pagos — quem tem ciclo de pagamento é a fatura.

Criar

Os tipos são FIXED (padrão), PARCELLED, RECURRENT e TRANSFER. Parcelado: type: "PARCELLED", installments: 12 e is_full_amount: true quando amount é o total da compra (a resposta é a primeira parcela; as demais nascem ligadas por connected_transaction_id). Recorrente: type: "RECURRENT" com frequency em DAILY, WEEKLY, BIWEEKLY, MONTHLY, BIMONTHLY, QUARTERLY, SEMIANNUAL ou YEARLY. Transferências entre contas têm rota própria: POST /v1/transactions/create-transfer.

Listar e filtrar

Veja Paginação e filtros. Um exemplo típico de planilha, o mês inteiro só de despesas pagas:

Editar e excluir séries

Em recorrências e parcelas, PUT /v1/transactions/{id} aceita edition_type no corpo e DELETE /v1/transactions/{id} aceita type, com o mesmo alcance: A exclusão responde 200 sem corpo. PUT só altera os campos enviados e devolve o lançamento atualizado.

Marcar como pago

POST /v1/transactions/{id}/paid alterna o status de um lançamento de conta. Para faturas de cartão use POST /v1/bills/pay/{id}.

Conciliar

Lançamentos previstos (criados à mão) podem ser ligados aos importados pelo Open Finance: GET /v1/transactions/reconcile-candidates lista os pares prováveis e POST /v1/transactions/{id}/reconcile liga; DELETE no mesmo caminho desfaz.

Em lote

PUT /v2/transactions/duplicate/update-many?transactions_ids=a&transactions_ids=b aplica o corpo (categoria, tags, etc.) a vários lançamentos de uma vez e devolve os atualizados; DELETE /v2/transactions/duplicate/delete-many exclui vários — os ids vão no corpo, em deletions: [{ "id": "…" }].