dinzo.api
Referência da APILançamentos

Criar lançamento

Cria um lançamento simples, uma compra parcelada (installments) ou uma regra de recorrência (recurrence). Aceita id (uuid) do cliente para idempotência em criações simples (replay do mesmo payload devolve a linha com deduped: true e status 200; payload divergente devolve 409 id_conflict). Criação simples/parcelada devolve o lançamento criado (201); recorrência devolve o id da regra (201, ou 200 quando reaproveita uma regra equivalente).

POST
/v1/transactions

Authorization

bearerAuth
AuthorizationBearer <token>

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

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X POST "https://example.com/v1/transactions" \  -H "Content-Type: application/json" \  -d '{    "account_id": "string",    "type": "DEBIT",    "amount": 1,    "description": "string"  }'
{  "transaction": {    "id": "3c9f1e77-8a2b-4c6d-9e0f-1a2b3c4d5e6f",    "projected": false,    "projection": null,    "date": "2026-08-24",    "type": "DEBIT",    "status": "POSTED",    "amount": 149.9,    "currency": "BRL",    "description": "Farmacia Sao Joao",    "notes": "Remedio mensal",    "account_id": "1a2b3c4d-5e6f-4a1b-9c8d-7e6f5a4b3c2d",    "bill_to_account_id": null,    "category_id": null,    "tags": [],    "recurrence_id": null,    "recurrence_period_date": null,    "installment": null,    "transfer_group_id": null,    "created_by_user": true,    "source": "API",    "hide_from_results": false,    "card_number": null,    "holder": null,    "holder_is_me": false,    "original_description": null,    "receipt_url": null,    "open_finance": false  }}

GETListar lançamentos

Lista a visão canônica mesclada (linhas persistidas + projeções mocked-*) dentro de uma janela `from`/`to` obrigatória (YYYY-MM-DD, máx. 366 dias), com filtros por conta, categoria, tag, tipo, status, subtipo, fatura, busca textual e ocultos. Retorna a página ordenada (dia mais novo primeiro, id ascendente dentro do dia) com paginação por cursor.

GETListar possíveis duplicatas

Agrupa lançamentos que parecem duplicados (mesma descrição, valor e tipo) dentro de uma janela `from`/`to` opcional (YYYY-MM-DD). Retorna os grupos com suas linhas, contagens e o período efetivamente analisado.