Zum Hauptinhalt springen
GET
curl
Der Endpoint Get an Account von Didit gibt ein einzelnes Konto mit seinen Kennungen, Inhabern, der Aktualität der Synchronisierung und der Abdeckung des Verlaufs zurück. sync.last_synced_at ist der Zeitpunkt, zu dem Didit zuletzt Daten von der Bank abgerufen hat. Vollständige Kennungen erfordern die Bankdatenberechtigung für Ihren API-Schlüssel. Siehe Konten, Guthaben und Transaktionen.

Autorisierungen

x-api-key
string
header
erforderlich

Der API-Schlüssel Ihrer Anwendung, zu finden unter Developers -> API keys in der Business Console. Der primäre Schlüssel hat vollen Zugriff. Ein benannter Schlüssel kann eingeschränkt werden: pro Ressource keine, nur Lese- oder nur Schreibrechte, begrenzt auf einzelne Workflows oder nur auf genehmigte Sitzungen, auf eine Liste von IP-Adressen und auf ein Ablaufdatum. 401 bedeutet, dass der Schlüssel falsch, widerrufen oder abgelaufen ist. 403 bedeutet, dass kein Schlüssel gesendet wurde, der Schlüssel keinen Zugriff auf diese Ressource oder Aktion hat oder die Anfrage von einer Adresse außerhalb seiner IP-Liste kam. 404 bei einer Sitzungsroute bedeutet, dass die Sitzung außerhalb der Workflows oder Status des Schlüssels liegt. Ein Schlüssel ohne Medienzugriff erhält Bild-, Video- und PDF-URLs als null, und ein Schlüssel ohne Schreibzugriff auf Sitzungen erhält Sitzungslinks und Tokens als null. Siehe https://docs.didit.me/console/api-keys.

Pfadparameter

account_id
string<uuid>
erforderlich

Die Konto-ID.

Antwort

Das Konto.

Ein Konto innerhalb einer Verbindung.

id
string<uuid>
erforderlich

Konto-ID. Gehört zur Verbindung und ändert sich während ihres Bestehens nie, auch nicht bei Erneuerungen.

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

Der Produktname der Bank.

type
enum<string>
erforderlich
Verfügbare Optionen:
current,
savings,
card,
loan,
investment,
other
usage
enum<string>
erforderlich
Verfügbare Optionen:
personal,
business,
unknown
currency
string
erforderlich

ISO-4217-Währungscode.

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

Name des Kontoinhabers, sofern die Bank ihn übermittelt.

holders
object[]
erforderlich

Von der Bank übermittelte Inhaber. Für die Eigentümerstruktur zählen nur holder und joint_holder.

identifiers
object
erforderlich

Vollständige Kennungen, die serverseitigen Aufrufern mit der Berechtigung für Bankdaten zurückgegeben werden.

account_ref
string | null
erforderlich

Kennzeichnet dasselbe Bankkonto über Verbindungen einer Anwendung und Umgebung hinweg: ein mit einem Schlüssel gebildeter Hash aus den eigenen Kennungen der Bank. null, wenn die Bank keine verlässliche Kennung liefert. Damit erkennen Sie ein Bankkonto wieder, das Ihnen bereits bekannt ist.

account_ref_previous
string | null
erforderlich

Der vorherige account_ref, nur für einen verifizierten Alias, etwa bei einer Bankmigration.

status
enum<string>
erforderlich

access_removed: Die Person hat das Konto aus der Einwilligung entfernt. Es wird nicht mehr synchronisiert.

Verfügbare Optionen:
open,
closed,
access_removed
scopes_granted
enum<string>[]
erforderlich
Verfügbare Optionen:
accounts,
balances,
transactions
sync
object
erforderlich
history_coverage
object
erforderlich

Welchen Teil des angeforderten Verlaufs die Bank geliefert hat.

Zuletzt geändert am 22. November 2026