Passer au contenu principal
GET
curl
L’endpoint Get an Institution de Didit renvoie une banque avec ses capacités et son état. Une valeur jamais observée est null, jamais une supposition.

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 chemin

id
string
requis

L'identifiant de l'établissement, par exemple es-banco-norte.

Réponse

La banque.

Une banque et les fonctionnalités qu'elle prend en charge. Les valeurs proviennent de données de capacités observées, actualisées chaque jour ; une valeur jamais observée vaut null, et non une supposition.

id
string
requis

Identifiant Didit de la banque, un slug stable.

Exemple:

"es-banco-norte"

name
string
requis
country
string
requis
Pattern: ^[A-Z]{3}$
logo_url
string<uri> | null
requis
timezone
string | null
requis

Fuseau horaire IANA dans lequel sont exprimées les dates de la banque.

segments
enum<string>[]
requis
Options disponibles:
personal,
business
access
enum<string>[]
requis

ongoing n'est listé que lorsque l'accès continu est activé pour la banque.

Options disponibles:
one_time,
ongoing
ongoing_access
boolean
requis

Si l'accès continu est disponible auprès de cette banque.

Le consentement le plus long autorisé par la banque, en jours. null si non observé.

history_days_max
integer | null
requis

La profondeur d'historique maximale fournie par la banque, en jours. null si elle n'a pas été observée.

pending_transactions
boolean | null
requis

Si la banque signale les transactions en attente.

pending_linkage
boolean | null
requis

Si la banque relie une transaction en attente à la transaction comptabilisée correspondante, ce qui définit pending_id.

balance_types
enum<string>[]
requis
Options disponibles:
booked,
available,
expected
transaction_fields
string[]
requis

Les champs de transaction que la banque est connue pour transmettre. Tous les autres champs valent null.

sign_in
enum<string> | null
requis

Mode de connexion de la personne à la banque.

Options disponibles:
redirect,
app_approval,
credentials,
null
requires_end_user_email
boolean | null
requis

Si Bank Link exige une adresse e-mail vérifiée pour la personne.

corporate_accounts
boolean | null
requis

Si les comptes professionnels sont pris en charge.

bank_account_selection
boolean | null
requis

Si la personne choisit les comptes auprès de la banque plutôt que dans Bank Link.

Si la banque demande une confirmation supplémentaire pour libérer l'historique plus ancien.

reconfirmation
boolean | null
requis

Si un renouvellement peut être reconfirmé sur l'écran de Didit sans nouvelle connexion à la banque.

sync_frequency_hours
integer | null
requis

Nombre d'heures entre deux synchronisations automatiques, lorsque la banque autorise une cadence plus rapide. null correspond à la valeur quotidienne par défaut.

health
enum<string>
requis
Options disponibles:
operational,
degraded,
down
Dernière modification le 22 novembre 2026