1. Cuentas
Fidi X Developer Preview
  • Fidi X
    • Introducción
    • 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
      • Obtener jerarquía de persona
      • Bloquear persona y descendientes
      • Desbloquear persona y descendientes
      • Actualizar datos de persona
      • Eliminar persona (soft delete)
    • Transacciones
      • Crear Transacción
      • Create Notification
    • Operaciones
      • Listar Operaciones
    • Webhooks
      • Formato de Notificaciones Webhook
      • Crear Suscripción Webhook
      • Listar Suscripciones
      • Obtener Suscripción
      • Actualizar Suscripción
      • Eliminar Suscripción
  • Schemas
    • UnlinkAccountResponse
    • AccountListResponse
    • CreateSubscriptionRequest
    • UpdateAccountRequest
    • Person
    • LinkBankAccountRequest
    • PersonHierarchyResponse
    • HTTPValidationError
    • UpdateSubscriptionRequest
    • LinkBankAccountResponse
    • BlockPersonDataResponse
    • CreateTransactionRequest
    • CreateAccountRequest
    • AccountResponse
    • DeliveryInfo
    • BalanceResponse
    • TransactionDataResponse
    • AssetResponse
    • AuthResponse
    • CreatePersonRequest
    • PersonResponse
    • ErrorResponse
    • TransactionOperation
    • CreateWebhookSubscriptionRequest
    • WebhookSubscriptionResponse
    • WebhookEventType
    • SubscriptionResponse
    • UpdateWebhookSubscriptionRequest
    • LinkBankAccountDataResponse
    • CreateAssetRequest
    • SubscriptionListResponse
    • TransactionCreateResponse
    • AccountDetailResponse
    • WebhookSubscriptionListResponse
    • AssetListResponse
    • WebhookEventTypesResponse
    • LedgerResponse
    • WebhookEventsListResponse
    • PersonDataResponse
    • WebhookEventRecord
    • SimulateExternalTransferRequest
    • PersonListResponse
    • SimulateExternalTransferResponse
    • TransactionResponse
  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
JWT Bearer
Agregar el parámetro
Authorization
a Encabezados
Ejemplo:
Authorization: ********************
or
Parámetros de consulta

Parámetros de Header

Respuestas

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

🟠400
🟠401
🔴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 'Authorization: Bearer <token>'
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-05-12 17:07:13
Anterior
Obtener Cuenta por ID
Siguiente
Actualizar Cuenta
Built with