Saltar al contingut principal
GET
curl
L’endpoint Get an Institution de Didit retorna un banc amb les seves capacitats i el seu estat. Un valor que mai no s’ha observat és null, no una suposició.

Autoritzacions

x-api-key
string
header
requerit

La clau d'API de la teva aplicació, des de Developers -> API keys a la Business Console. La clau principal té accés complet. Una clau amb nom es pot limitar: cap, lectura o escriptura per recurs, limitada a alguns fluxos de treball o a sessions aprovades, a una llista d'adreces IP i a una data de caducitat. 401 vol dir que la clau és incorrecta, revocada o caducada; 403 vol dir que no s'ha enviat cap clau, que la clau no té accés a aquest recurs o acció, o que la sol·licitud ve d'una adreça fora de la seva llista d'adreces IP; 404 en una ruta de sessió vol dir que la sessió queda fora dels fluxos de treball o estats de la clau. Una clau sense accés a multimèdia rep les URL d'imatges, vídeos i PDF com a null, i una clau sense escriptura de sessions rep els enllaços i els tokens de sessió com a null. Vegeu https://docs.didit.me/console/api-keys.

Paràmetres de ruta

id
string
requerit

L'identificador de la institució, per exemple es-banco-norte.

Resposta

El banc.

Un banc i el que admet. Els valors provenen de dades de capacitat observades, actualitzades cada dia; un valor mai observat és null, no una suposició.

id
string
requerit

Identificador del banc de Didit, un slug estable.

Exemple:

"es-banco-norte"

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

Fus horari IANA en què estan les dates del banc.

segments
enum<string>[]
requerit
Opcions disponibles:
personal,
business
access
enum<string>[]
requerit

ongoing només apareix en els bancs on l'accés continu està activat.

Opcions disponibles:
one_time,
ongoing
ongoing_access
boolean
requerit

Si hi ha accés continu disponible en aquest banc.

El consentiment més llarg que permet el banc, en dies. null quan no s'ha observat.

history_days_max
integer | null
requerit

La història més profunda que lliura el banc, en dies. null quan no s'ha observat.

pending_transactions
boolean | null
requerit

Si el banc informa de les transaccions pendents.

pending_linkage
boolean | null
requerit

Si el banc vincula una transacció pendent amb la seva comptabilitzada, que és el que defineix pending_id.

balance_types
enum<string>[]
requerit
Opcions disponibles:
booked,
available,
expected
transaction_fields
string[]
requerit

Els camps de transacció que se sap que el banc envia. La resta de camps són null.

sign_in
enum<string> | null
requerit

Com inicia la persona la sessió al banc.

Opcions disponibles:
redirect,
app_approval,
credentials,
null
requires_end_user_email
boolean | null
requerit

Si Bank Link necessita una adreça de correu electrònic verificada de la persona.

corporate_accounts
boolean | null
requerit

Si s'admeten comptes d'empresa.

bank_account_selection
boolean | null
requerit

Si la persona tria els comptes al banc en lloc de fer-ho a Bank Link.

Si el banc demana una confirmació més per alliberar l'historial més antic.

reconfirmation
boolean | null
requerit

Si una renovació es pot reconfirmar a la pantalla de Didit sense iniciar sessió al banc.

sync_frequency_hours
integer | null
requerit

Hores entre sincronitzacions automàtiques quan el banc permet una cadència més ràpida. null vol dir el valor diari per defecte.

health
enum<string>
requerit
Opcions disponibles:
operational,
degraded,
down
Darrera modificació el 22 de novembre del 2026