1. Cuentas
Fidi X Developer Preview
  • Fidi X
    • Introducción
    • Conceptos Fundamentales
    • Catálogo de APIs
      • Diccionario de Datos - Enumeraciones
      • Autenticación
        • Obtener Token de Acceso
      • Cuentas
        • Crear Cuenta
          POST
        • Obtener Cuenta por ID
          GET
        • Listar Cuentas por Ledger
          GET
        • Actualizar Cuenta
          PUT
        • Eliminar Cuenta
          DELETE
        • Suspender Cuenta
          PATCH
        • Activar Cuenta
          PATCH
        • Obtener Balance de Cuenta
          GET
        • Obtener Cuentas linkeadas
          GET
        • Linkear Cuenta Bancaria
          POST
        • Deslinkear Cuenta Bancaria
          DELETE
      • Personas
        • Crear Persona
        • Listar Personas
        • Obtener Persona por ID
        • Actualizar datos de persona
        • Eliminar persona (soft delete)
        • Obtener jerarquía de persona
        • Bloquear persona y descendientes
        • Desbloquear persona y descendientes
      • Transacciones y Operaciones
        • Transacciones
          • Crear Transacción
        • Operations
          • Listar Operaciones
      • Webhooks
        • Crear Suscripción Webhook
        • Listar Suscripciones
        • Obtener Suscripción
        • Actualizar Suscripción
        • Eliminar Suscripción
      • Ledgers
        • Activar Ledger
        • Deshabilitar Ledger
  • Casos de Uso
    • Cuentas Virtuales
      • Guía de implementación
      • Create Notification
  • Raíz
  1. Cuentas

Listar Cuentas por Ledger

GET
/fidix/v1/accounts
Obtiene todas las cuentas filtradas por ledger_id.
Uso de Variables: Puedes usar ${ledger_id} si guardaste el ID de un ledger previamente.
Nota: Este endpoint retorna una lista de cuentas. Puedes usar el primer elemento o filtrar por ID específico.

Solicitud

Autorización
or
Parámetros de consulta

Parámetros de Header

Respuestas

🟢200
application/json
Lista de cuentas obtenida exitosamente
Bodyapplication/json

🟠400
🟠401
🟠403
🟠404
🔴500
Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
curl --location 'https://sandbox.fidi.money/fidix/v1/accounts?ledger_id=c2b5d3b8-6f5e-4b34-9c9b-2a5e2c1f7a10&limit=25&offset=50' \
--header 'traceparent: 00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01' \
--header 'x-api-key: {{apikey}}' \
--header 'x-api-key: {{apikey}}'
Respuesta Ejemplo de Respuesta
200 - Lista de cuentas
{
    "data": {
        "accounts": [
            {
                "id": "b188d3e9-c5b7-4bf3-ba22-879d1e6156f0",
                "ledger_id": "7b35fa34-bfef-4736-971c-90a2996bc892",
                "name": "Cuenta de Efectivo",
                "asset_id": "c55f6e5c-1c44-4ac2-a117-5fa2bd56661d",
                "owner_id": "1f8a6d59-3c8b-5e3b-b3f2-0e0b7c4a2b34",
                "normal_balance": "CREDIT",
                "status": "active",
                "created_at": "2026-05-06T12:45:32.276018Z",
                "updated_at": "2026-05-08T14:09:53.700054Z"
            }
        ]
    },
    "metadata": {
        "limit": 1,
        "offset": 0,
        "total": 27,
        "has_next": true,
        "has_prev": false,
        "total_pages": 27
    }
}
Modificado en 2026-07-27 21:28:06
Anterior
Obtener Cuenta por ID
Siguiente
Actualizar Cuenta
Built with