Idea+Cash Developers
Login
Guias

Consultar saldo e extrato

Para uso em backoffice, conciliação e dashboards financeiros.

Referência de conta e headers
Toda request sobre uma conta identifica a conta por header: envie account-id (o accountId recebido no onboarding), wallet-id ou tax-identifier — precedência wallet-id > tax-identifier > account-id. Some a isso Authorization e tenantid; em DEV, também hostdevelop: apiapp.dev.ideabank.com.br. Sem nenhum header de conta a API responde 422 (account, wallet or tax-identifier header is required); se a integração não estiver vinculada à conta, 403.

Saldo

GET/integration/v1/account/balance
curl "https://apiapp.dev.ideabank.com.br/integration/v1/account/balance" \
  -H "Authorization: Bearer $TOKEN" \
  -H "tenantid: $TENANT_ID" -H "account-id: $ACCOUNT_ID" -H "hostdevelop: apiapp.dev.ideabank.com.br"

Alternativa: header tax-identifier: <CPF/CNPJ> ou wallet-idem vez de account-id.

Extrato paginado

GET/integration/v1/statement

Filtre por período com from, to e limit. Ideal para conciliação diária automatizada.

curl "https://apiapp.dev.ideabank.com.br/integration/v1/statement?from=2026-06-01&to=2026-06-30&limit=100" \
  -H "Authorization: Bearer $TOKEN" \
  -H "tenantid: $TENANT_ID" -H "account-id: $ACCOUNT_ID" -H "hostdevelop: apiapp.dev.ideabank.com.br"