dinzo.api
Referência da APIContas

Criar conta

Cria uma conta manual (banco ou cartão de crédito). O ícone pode ser informado por icon_id ou resolvido por icon_name. Retorna a conta criada com o saldo já calculado e o id da transação de saldo inicial, quando um saldo inicial foi informado.

POST
/v1/accounts

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/accounts" \  -H "Content-Type: application/json" \  -d '{    "type": "BANK"  }'
{  "id": "d049d327-1ec0-4bb3-ad16-6b34f21f2d7d",  "type": "BANK",  "sub_type": "SAVINGS_ACCOUNT",  "title": "Reserva de emergência",  "archived": false,  "exclude_from_totals": false,  "currency": "BRL",  "balance": 5000,  "credit": null,  "pay_bill_from_account_id": null,  "icon_id": "de8e90de-2194-4274-bd7c-2e79a7d95914",  "card_icon_id": null,  "open_finance": {    "connected": false,    "connector_name": null  },  "card_holders": null,  "created_at": "2026-08-24T18:41:03.000Z",  "initial_balance_transaction_id": "4dd7c72f-8198-41b4-9be3-2e3595d5849b"}

GETListar contas

Lista todas as contas e cartões de crédito do usuário autenticado, cada um com o saldo calculado (contas arquivadas retornam saldo nulo). Retorna um objeto com a lista em `data`, ordenada por data de criação.

GETBuscar conta

Retorna uma conta específica do usuário pelo id, com o saldo calculado. Responde 404 quando a conta não existe ou não pertence ao usuário.