Fidi X
  1. List Persons
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
          GET
        • List Natural Persons Only
          GET
        • List Legal Persons Only
          GET
        • List Active Persons Only
          GET
      • 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
        • 400 - Invalid Account ID Format (F001)
        • 404 - Account Not Found (F003)
        • 404 - Balance Not Found (F004)
        • 500 - Internal Server Error (T001)
    • 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. List Persons

List Legal Persons Only

GET
/fidix/v1/persons
List only legal persons

Solicitud

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

Parámetros de Header

Respuestas

🟢200
application/json
Body

Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
curl --location --request GET '/fidix/v1/persons?person_type=LEGAL&limit=20&offset=0' \
--header 'X-Organization-ID: {{organization_id}}' \
--header 'Authorization: Bearer <token>'
Respuesta Ejemplo de Respuesta
{
  "persons": [
    {
      "id": "92061b7d-4792-4ad8-b918-ec1587d8fdca",
      "organization_id": "00000000-0000-0000-0000-000000000001",
      "person_type": "LEGAL",
      "email": "contacto@fidi.cl",
      "status": "ACTIVE",
      "company_name": "Fidi SpA",
      "created_at": "2025-12-22T10:30:00Z",
      "updated_at": "2025-12-22T10:30:00Z"
    }
  ],
  "pagination": {
    "total": 1,
    "limit": 20,
    "offset": 0
  },
  "metadata": {
    "trace_id": "list-legal-456",
    "timestamp": "2025-12-22T11:00:00Z"
  }
}
Modificado en 2025-12-22 20:48:00
Anterior
List Natural Persons Only
Siguiente
List Active Persons Only
Built with