Saltar al contenido principal
GET
curl
El endpoint Obtener una cuenta de Didit devuelve una cuenta con sus identificadores, titulares, recencia de la sincronización y cobertura del historial. sync.last_synced_at indica el momento en que Didit obtuvo por última vez los datos del banco. Los identificadores completos requieren el permiso de datos bancarios en tu clave de API. Consulta Cuentas, saldos y transacciones.

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

account_id
string<uuid>
requerido

El id de la cuenta.

Respuesta

La cuenta.

Una cuenta dentro de una conexión.

id
string<uuid>
requerido

ID de la cuenta. Pertenece a la conexión y no cambia mientras exista, incluidas las renovaciones.

connection_id
string<uuid>
requerido
name
string | null
requerido
product
string | null
requerido

El nombre del producto del banco.

type
enum<string>
requerido
Opciones disponibles:
current,
savings,
card,
loan,
investment,
other
usage
enum<string>
requerido
Opciones disponibles:
personal,
business,
unknown
currency
string
requerido

Código de moneda ISO 4217.

Pattern: ^[A-Z]{3}$
holder_name
string | null
requerido

Nombre del titular cuando el banco lo comparte.

holders
object[]
requerido

Titulares que comparte el banco. Para la propiedad, solo se tienen en cuenta holder y joint_holder.

identifiers
object
requerido

Identificadores completos, devueltos a las llamadas desde el servidor con el permiso de datos bancarios.

account_ref
string | null
requerido

Identifica la misma cuenta bancaria entre conexiones de una misma aplicación y entorno: un hash con clave de los propios identificadores del banco. null cuando el banco no proporciona un identificador fiable. Úsalo para reconocer una cuenta bancaria que ya conoces.

account_ref_previous
string | null
requerido

El account_ref anterior, solo para un alias verificado, como una migración de banco.

status
enum<string>
requerido

access_removed: la persona eliminó la cuenta del consentimiento. Ya no se sincroniza.

Opciones disponibles:
open,
closed,
access_removed
scopes_granted
enum<string>[]
requerido
Opciones disponibles:
accounts,
balances,
transactions
sync
object
requerido
history_coverage
object
requerido

Lo que el banco entregó del historial que solicitaste.

Última modificación el 22 de noviembre de 2026