Skip to main content
GET
curl
Didit’s Get Account Balances endpoint returns the typed balances of an account with their reference dates. type is booked, available or expected. Reads never bill.

Authorizations

x-api-key
string
header
required

Your application's API key, from Developers -> API keys in the Business Console. The primary key has full access. A named key can be scoped: none, read or write per resource, limited to some workflows or to approved sessions, to a list of IP addresses, and to an expiry date. 401 means the key is wrong, revoked or expired; 403 means no key was sent, the key has no access to this resource or action, or the request came from an address outside its IP list; 404 on a session route means the session is outside the key's workflows or statuses. A key without media access receives image, video and PDF URLs as null, and a key without sessions write receives session links and tokens as null. See https://docs.didit.me/console/api-keys.

Path Parameters

account_id
string<uuid>
required

The account id.

Response

The balances.

Typed balances of an account.

account_id
string<uuid>
required
balances
object[]
required
last_synced_at
string<date-time> | null
required

When the balances were last fetched from the bank.

Last modified on November 22, 2026