Passer au contenu principal
GET
curl
Le endpoint List Bank Connections de Didit renvoie vos connexions bancaires, filtrées par statut, accès, banque, pays, vos propres références et date de fin du consentement. Utilisez consent_expires_before pour trouver les consentements à renouveler et end_user_reference pour trouver les connexions d’un client. La liste est paginée avec cursor.

Autorisations

x-api-key
string
header
requis

La clé API de votre application, disponible dans Developers -> API keys de la Business Console. La clé principale a un accès complet. Une clé nommée peut être limitée : aucun accès, lecture ou écriture par ressource, restreinte à certains workflows ou à certaines sessions approuvées, à une liste d'adresses IP et à une date d'expiration. 401 signifie que la clé est incorrecte, révoquée ou expirée ; 403 signifie qu'aucune clé n'a été envoyée, que la clé n'a pas accès à cette ressource ou à cette action, ou que la requête provient d'une adresse hors de sa liste d'adresses IP ; 404 sur une route de session signifie que la session se trouve hors des workflows ou des statuts de la clé. Une clé sans accès aux médias reçoit les URL des images, vidéos et PDF à null, et une clé sans accès en écriture aux sessions reçoit les liens et tokens de session à null. Voir https://docs.didit.me/console/api-keys.

Paramètres de requête

status
enum<string>

Uniquement les connexions ayant ce statut.

Options disponibles:
pending,
active,
renewal_required,
paused,
revoked,
deleted,
failed
access
enum<string>

Uniquement ce mode d'accès.

Options disponibles:
one_time,
ongoing
institution_id
string

Uniquement cette banque.

Maximum string length: 64
country
string

Uniquement les banques de ce pays.

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

Uniquement les connexions ayant ce vendor_data.

Maximum string length: 255
end_user_reference
string

Uniquement les connexions ayant cette end_user.reference.

Maximum string length: 255

Uniquement les connexions dont le consentement prend fin avant cette date et heure, par exemple pour envoyer des liens de renouvellement.

created_after
string<date-time>

Uniquement les connexions créées après cette date et heure.

limit
integer
défaut:100

Taille de page, de 1 à 500. Par défaut 100.

Plage requise: 1 <= x <= 500
cursor
string

Curseur opaque issu de next_cursor de la page précédente.

Réponse

Une page de connexions.

Une page de connexions.

items
object[]
requis
next_cursor
string | null
requis

À transmettre comme cursor pour la page suivante. null sur la dernière page.

Dernière modification le 22 novembre 2026