Zum Hauptinhalt springen
GET
curl
Der Endpoint List Bank Connections von Didit gibt Ihre Verbindungen zurück, gefiltert nach Status, Zugriff, Bank, Land, Ihren eigenen Referenzen und dem Enddatum der Einwilligung. Verwenden Sie consent_expires_before, um Einwilligungen zu finden, die erneuert werden müssen, und end_user_reference, um die Verbindungen eines Kunden zu finden. Die Liste wird mit cursor paginiert.

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.

Abfrageparameter

status
enum<string>

Nur Verbindungen mit diesem Status.

Verfügbare Optionen:
pending,
active,
renewal_required,
paused,
revoked,
deleted,
failed
access
enum<string>

Nur dieser Zugriffsmodus.

Verfügbare Optionen:
one_time,
ongoing
institution_id
string

Nur diese Bank.

Maximum string length: 64
country
string

Nur Banken in diesem Land.

Pattern: ^[A-Z]{3}$
vendor_data
string

Nur Verbindungen mit diesem vendor_data.

Maximum string length: 255
end_user_reference
string

Nur Verbindungen mit diesem end_user.reference.

Maximum string length: 255

Nur Verbindungen, deren Einwilligung vor diesem Zeitpunkt endet, zum Beispiel um Verlängerungslinks zu senden.

created_after
string<date-time>

Nur Verbindungen, die nach diesem Zeitpunkt erstellt wurden.

limit
integer
Standard:100

Seitengröße, 1 bis 500. Standard 100.

Erforderlicher Bereich: 1 <= x <= 500
cursor
string

Opaker Cursor aus dem next_cursor der vorherigen Seite.

Antwort

Eine Seite mit Verbindungen.

Eine Seite mit Verbindungen.

items
object[]
erforderlich
next_cursor
string | null
erforderlich

Übergeben Sie ihn als cursor für die nächste Seite. null auf der letzten Seite.

Zuletzt geändert am 22. November 2026