Skip to main content
GET
curl
Didit’s Get an Account endpoint returns one account with its identifiers, holders, sync freshness and history coverage. sync.last_synced_at is when Didit last fetched from the bank. Full identifiers need the bank data permission on your key. See Accounts, balances and transactions.

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

One account inside a connection.

id
string<uuid>
required

Account id. Belongs to the connection and never changes while it exists, renewals included.

connection_id
string<uuid>
required
name
string | null
required
product
string | null
required

The bank's product name.

type
enum<string>
required
Available options:
current,
savings,
card,
loan,
investment,
other
usage
enum<string>
required
Available options:
personal,
business,
unknown
currency
string
required

ISO 4217 currency code.

Pattern: ^[A-Z]{3}$
holder_name
string | null
required

Holder name where the bank shares it.

holders
object[]
required

Holders the bank shares. Ownership counts only holder and joint_holder.

identifiers
object
required

Full identifiers, returned to server-side callers with the bank data permission.

account_ref
string | null
required

Identifies the same bank account across connections of one application and environment: a keyed hash of the bank's own identifiers. null when the bank gives no reliable identifier. Use it to recognise a bank account you already know.

account_ref_previous
string | null
required

The previous account_ref, only for a verified alias such as a bank migration.

status
enum<string>
required

access_removed: the person removed the account from the consent. It is no longer synced.

Available options:
open,
closed,
access_removed
scopes_granted
enum<string>[]
required
Available options:
accounts,
balances,
transactions
sync
object
required
history_coverage
object
required

What the bank delivered of the history you asked for.

Last modified on November 22, 2026