Saltar al contenido principal
GET
curl
El endpoint para obtener una institución de Didit devuelve un banco con sus capacidades y su estado. Un valor que nunca se ha observado es null, no una suposición.

Autorizaciones

x-api-key
string
header
requerido

La clave de API de tu aplicación, desde Developers -> API keys en la Business Console. La clave principal tiene acceso completo. Una clave con nombre puede tener permisos limitados: ninguno, lectura o escritura por recurso, restringida a algunos flujos o solo a sesiones aprobadas, a una lista de direcciones IP y a una fecha de caducidad. 401 significa que la clave es incorrecta, está revocada o ha caducado; 403 significa que no se envió ninguna clave, que la clave no tiene acceso a este recurso o acción, o que la solicitud procede de una dirección fuera de su lista de IP; 404 en una ruta de sesión significa que la sesión está fuera de los flujos o estados de la clave. Una clave sin acceso a contenido multimedia recibe las URL de imágenes, vídeos y PDF como null, y una clave sin permiso de escritura en sesiones recibe los enlaces y tokens de sesión como null. Consulta https://docs.didit.me/console/api-keys.

Parámetros de ruta

id
string
requerido

El id de la entidad, por ejemplo es-banco-norte.

Respuesta

El banco.

Un banco y lo que admite. Los valores proceden de datos de capacidades observados y se actualizan a diario; un valor nunca observado es null, no una suposición.

id
string
requerido

Identificador del banco en Didit, un slug estable.

Ejemplo:

"es-banco-norte"

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

Zona horaria IANA en la que están las fechas del banco.

segments
enum<string>[]
requerido
Opciones disponibles:
personal,
business
access
enum<string>[]
requerido

ongoing solo aparece en los bancos donde el acceso continuo está activado.

Opciones disponibles:
one_time,
ongoing
ongoing_access
boolean
requerido

Si el acceso continuo está disponible en este banco.

El consentimiento más largo que permite el banco, en días. null cuando no se ha observado.

history_days_max
integer | null
requerido

El historial más extenso que entrega el banco, en días. null cuando no se ha observado.

pending_transactions
boolean | null
requerido

Si el banco informa de las transacciones pendientes.

pending_linkage
boolean | null
requerido

Si el banco vincula una transacción pendiente con su transacción contabilizada, lo que determina pending_id.

balance_types
enum<string>[]
requerido
Opciones disponibles:
booked,
available,
expected
transaction_fields
string[]
requerido

Los campos de transacción que se sabe que el banco envía. Todos los demás campos son null.

sign_in
enum<string> | null
requerido

Cómo inicia sesión la persona en el banco.

Opciones disponibles:
redirect,
app_approval,
credentials,
null
requires_end_user_email
boolean | null
requerido

Si Bank Link requiere una dirección de correo electrónico verificada de la persona.

corporate_accounts
boolean | null
requerido

Si se admiten cuentas de empresa.

bank_account_selection
boolean | null
requerido

Si la persona elige las cuentas en el banco en lugar de en Bank Link.

Si el banco pide una confirmación adicional para liberar el historial más antiguo.

reconfirmation
boolean | null
requerido

Si una renovación puede reconfirmarse en la pantalla de Didit sin iniciar sesión en el banco.

sync_frequency_hours
integer | null
requerido

Horas entre sincronizaciones automáticas cuando el banco permite una frecuencia mayor. null significa el valor diario por defecto.

health
enum<string>
requerido
Opciones disponibles:
operational,
degraded,
down
Última modificación el 22 de noviembre de 2026