dinzo.api
Referência da APIContas

Listar 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.

GET
/v1/accounts

Authorization

bearerAuth
AuthorizationBearer <token>

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

In: header

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/v1/accounts"
{  "data": [    {      "id": "17f5dcd0-83cb-4779-b760-3912947401e8",      "type": "BANK",      "sub_type": "CHECKING_ACCOUNT",      "title": "Nubank",      "archived": false,      "exclude_from_totals": false,      "currency": "BRL",      "balance": 4820.57,      "credit": null,      "pay_bill_from_account_id": null,      "icon_id": "d5920881-eaa2-489f-b683-3947880fc3a0",      "card_icon_id": null,      "open_finance": {        "connected": true,        "connector_name": "Nubank"      },      "card_holders": null,      "created_at": "2026-01-14T13:22:41.000Z"    },    {      "id": "459af7c0-c917-4a18-9b3f-c6b4739b7a08",      "type": "CREDIT",      "sub_type": "CREDIT_CARD",      "title": "Itaú Uniclass",      "archived": false,      "exclude_from_totals": false,      "currency": "BRL",      "balance": -1167.29,      "credit": {        "close_day": 3,        "due_day": 10,        "due_day_of_month": 10,        "cycle_auto": true,        "limit": 12000      },      "pay_bill_from_account_id": "17f5dcd0-83cb-4779-b760-3912947401e8",      "icon_id": "6d9c748a-c2cd-441f-a9ab-813d54ba72b8",      "card_icon_id": "2b337b22-2924-4a2c-abb1-1342497ebe00",      "open_finance": {        "connected": true,        "connector_name": "Itaú"      },      "card_holders": {        "3706": "me",        "8747": "Stefanie"      },      "created_at": "2026-02-02T09:05:11.000Z"    }  ]}

GETObter visão geral financeira

Snapshot de uma chamada: saldo bancário, dívida de cartão em aberto, patrimônio líquido, as faturas projetadas dos próximos 30 dias, o resultado do mês corrente (BRT) e o saldo previsto ancorado no saldo atual. É o gêmeo REST da ferramenta MCP visao_geral.

POSTCriar 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.