1. Get Balance by Account ID
Fidi X
  • Fidi X - API's Core Wallet
    • Diccionario de Datos – Enumeraciones
    • Auth
      • Login
        • Get Access Token
    • Personas
      • Create Person
        • Create Natural Person (Complete)
        • Create Legal Person (Company)
        • Create Natural Person with Parent
      • Get Person
        • Get Person by ID
        • Get Person Hierarchy
      • List Persons
        • List All Persons
        • List Natural Persons Only
        • List Legal Persons Only
        • List Active Persons Only
      • Update Person
        • Update Natural Person
        • Update Legal Person
        • Update Person Status
      • Block & Unblock Person
        • Block Person and Descendants
        • Unblock Person and Descendants
      • Delete Person
        • Delete Person (Soft Delete)
    • Ledgers
      • Disable Ledger
        • 200 - Disable Ledger Success
        • 400 - Invalid Ledger ID (F006)
        • 404 - Ledger Not Found (F003)
        • 500 - Internal Server Error (T001)
      • Activate Ledger
        • 200 - Activate Ledger Success
        • 400 - Invalid Ledger ID (F006)
        • 400 - Invalid Action (F006)
        • 404 - Ledger Not Found (F003)
        • 500 - Internal Server Error (T001)
    • Assets
      • Create Asset
        • 201 - Create Asset Success (Fiat)
        • 201 - Create Asset Success (Crypto)
        • 201 - Create Asset Success (Points)
        • 400 - Missing Ledger ID (F001)
        • 400 - Missing Code (F001)
        • 400 - Missing Asset Type (F001)
        • 400 - Invalid Asset Type (F001)
        • 400 - Invalid Ledger ID Format (F001)
        • 400 - Code Too Long (F001)
        • 404 - Ledger Not Found (F003)
        • 409 - Duplicate Asset Code (F004)
        • 500 - Internal Server Error (T001)
      • Get Assets by Ledger
        • 200 - Get Assets Success (With Results)
        • 200 - Get Assets Success (Empty)
        • 400 - Missing Ledger ID (F005)
        • 400 - Invalid Ledger ID Format (F002)
        • 500 - Internal Server Error (T005)
      • Get Asset by ID
        • 200 - Get Asset Success
        • 400 - Invalid Asset ID Format (F002)
        • 404 - Asset Not Found (T006)
        • 500 - Internal Server Error (T007)
      • Activate Asset
        • 200 - Activate Asset Success
        • 400 - Invalid Asset ID (F002)
        • 400 - Invalid Action (F002)
        • 404 - Asset Not Found (F003)
        • 409 - Ledger Not Found (F003)
        • 500 - Internal Server Error (T001)
      • Disable Asset
        • 200 - Disable Asset Success
        • 400 - Invalid Asset ID (F002)
        • 404 - Asset Not Found (F003)
        • 409 - Ledger Not Found (F003)
        • 500 - Internal Server Error (T001)
    • Cuentas
      • Create Account
        • 201 - Create Account Success (Without Parent)
        • 201 - Create Account Success (With Parent)
        • 400 - Missing Name (F001)
        • 400 - Invalid Normal Balance (F001)
        • 400 - Invalid Ledger ID Format (F001)
        • 400 - Invalid Parent Account ID (F001)
        • 400 - Parent Account Not Found (F001)
        • 400 - Asset Ledger Mismatch (F001)
        • 500 - Internal Server Error (T001)
      • Get Account by ID
        • 200 - Get Account Success
        • 400 - Invalid Account ID Format (F001)
        • 404 - Account Not Found (F003)
        • 500 - Internal Server Error (T001)
      • Get Accounts by Ledger
        • 200 - Get Accounts Success (With Results)
        • 200 - Get Accounts Success (Empty)
        • 400 - Missing Ledger ID (F005)
        • 400 - Invalid Ledger ID Format (F006)
        • 500 - Internal Server Error (T002)
      • Update Account
        • 200 - Update Account Success
        • 400 - Invalid Account ID Format (F001)
        • 400 - Invalid Request Body (F002)
        • 400 - Name Empty (F005)
        • 404 - Account Not Found (F003)
        • 500 - Internal Server Error (T001)
      • Suspend Account
        • 200 - Suspend Account Success
        • 400 - Invalid Account ID (F002)
        • 400 - Invalid Action (F002)
        • 404 - Account Not Found (F003)
        • 409 - Account Closed (F004)
        • 500 - Internal Server Error (T001)
      • Activate Account
        • 200 - Activate Account Success
        • 400 - Invalid Account ID (F002)
        • 404 - Account Not Found (F003)
        • 409 - Account Closed (F004)
        • 500 - Internal Server Error (T001)
      • Close Account
        • 200 - Close Account Success
        • 400 - Invalid Account ID (F002)
        • 404 - Account Not Found (F003)
        • 500 - Internal Server Error (T001)
      • Get Balance by Account ID
        • 200 - Get Balance Success
          GET
        • 400 - Invalid Account ID Format (F001)
          GET
        • 404 - Account Not Found (F003)
          GET
        • 404 - Balance Not Found (F004)
          GET
        • 500 - Internal Server Error (T001)
          GET
    • Transacciones
      • Create Transaction
        • 201 - Create Transaction Success
        • 400 - Missing traceparent (F001)
        • 400 - Invalid UUID in payload (F002)
        • 201 - Idempotency: Return stored response (idem-001)
        • 409 - Idempotency conflict: same key, different payload (T002)
        • 409 - Duplicate reference_id for ledger (T003)
        • 400 - Invalid payload: debit/credit mismatch (F003)
        • 403 - Ledger not found or disabled (F004)
        • 403 - Account invalid or inactive (F004)
        • 400 - Asset/Currency mismatch (F005)
        • 409 - Authorization rules not satisfied (T001)
        • 500 - Failed to update balance after retries (T004)
        • 500 - Unexpected internal error (T004)
  1. Get Balance by Account ID

200 - Get Balance Success

GET
/fidix/v1/accounts/4f5a2d7a-4c1e-4f2a-9e9a-1234567890ab/balance

Solicitud

Autorización
Proporciona tu token bearer en el encabezado
Authorization
al realizar solicitudes a recursos protegidos.
Ejemplo:
Authorization: Bearer ********************
Parámetros de Header

Respuestas

🟢200
application/json
Body

Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://sandbox.fidi.cc/fidix/v1/accounts/4f5a2d7a-4c1e-4f2a-9e9a-1234567890ab/balance' \
--header 'traceparent: 00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01' \
--header 'Authorization: Bearer <token>'
Respuesta Ejemplo de Respuesta
{
  "account_id": "4f5a2d7a-4c1e-4f2a-9e9a-1234567890ab",
  "available": "1000.50",
  "blocked": "100.00",
  "in_flight": "50.25"
}
Modificado en 2025-12-26 18:07:42
Anterior
500 - Internal Server Error (T001)
Siguiente
400 - Invalid Account ID Format (F001)
Built with