Saltar al contenido principal
GET
curl
El endpoint List Bank Connections de Didit devuelve tus conexiones bancarias, filtradas por estado, acceso, banco, país, tus propias referencias y fecha de vencimiento del consentimiento. Usa consent_expires_before para encontrar los consentimientos que necesitan renovarse y end_user_reference para encontrar las conexiones de un usuario final. La lista se pagina mediante cursor.

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 consulta

status
enum<string>

Solo conexiones en este estado.

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

Solo este modo de acceso.

Opciones disponibles:
one_time,
ongoing
institution_id
string

Solo este banco.

Maximum string length: 64
country
string

Solo bancos de este país.

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

Solo conexiones con este vendor_data.

Maximum string length: 255
end_user_reference
string

Solo conexiones con este end_user.reference.

Maximum string length: 255

Solo conexiones cuyo consentimiento termina antes de este momento, por ejemplo para enviar enlaces de renovación.

created_after
string<date-time>

Solo conexiones creadas después de este momento.

limit
integer
predeterminado:100

Tamaño de página, de 1 a 500. Por defecto, 100.

Rango requerido: 1 <= x <= 500
cursor
string

Cursor opaco del next_cursor de la página anterior.

Respuesta

Una página de conexiones.

Una página de conexiones.

items
object[]
requerido
next_cursor
string | null
requerido

Pásalo como cursor para la página siguiente. null en la última página.

Última modificación el 22 de noviembre de 2026