> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # Consultar detalles del titular ## OpenAPI ````yaml es/openapi/v3-current/ledger.yaml get /v1/organizations/{organization_id}/holders/{holder_id} openapi: 3.1.0 info: title: API de Midaz Ledger description: >- Referencia completa de la API para los servicios de Midaz Ledger, incluyendo gestión de organizaciones, operaciones de ledger, activos, segmentos, portafolios, cuentas, tipos de cuenta, transacciones, operaciones, saldos, rutas de operación, rutas de transacción e índices de metadatos. version: 3.7.8 servers: - url: https://ledger.sandbox.lerian.net security: [] tags: - name: Organizations API - name: Ledgers API - name: Assets API - name: Segments API - name: Portfolios API - name: Account Types API - name: Accounts API - name: Balances API - name: Transactions API - name: Operations API - name: Operation Routes API - name: Transaction Routes API - name: Metadata Indexes API - name: Holders API - name: Instruments API - name: Billing Packages API - name: Packages API - name: Billing Calculation API - name: Estimation API - name: Encryption API - name: Protection API - name: Asset Rates API paths: /v1/organizations/{organization_id}/holders/{holder_id}: get: tags: - Holders API summary: Consultar detalles del titular parameters: - $ref: '#/components/parameters/OrganizationId' - name: holder_id in: path required: true description: ID del titular (UUID) schema: type: string - $ref: '#/components/parameters/XRequestId' - $ref: '#/components/parameters/Authorization' - description: Returns the holder even if it was logically deleted (true,false) explode: false in: query name: include_deleted schema: description: >- Devuelve el titular aunque haya sido eliminado lógicamente (true,false) type: string responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/Holder' default: description: Error content: application/problem+json: schema: $ref: '#/components/schemas/Error' components: parameters: OrganizationId: name: organization_id in: path description: El identificador único de la Organización asociada al Ledger. required: true example: 019c96a0-0a98-7287-9a31-786e0809c769 schema: type: string format: uuid XRequestId: name: X-Request-Id in: header description: Un identificador único utilizado para rastrear y seguir cada solicitud. required: false example: 019c96a0-0a98-7287-9a31-786e0809c769 schema: type: string format: uuid Authorization: name: Authorization in: header required: false schema: type: string description: > Token JWT bearer para autenticación. Requerido cuando `PLUGIN_AUTH_ENABLED=true` (obligatorio en despliegues multiinquilino). Opcional en el modo OSS de inquilino único predeterminado. Formato: `Bearer ` schemas: Holder: additionalProperties: false properties: addresses: $ref: '#/components/schemas/Addresses' contact: $ref: '#/components/schemas/Contact' createdAt: examples: - '2025-01-01T00:00:00Z' format: date-time type: string deletedAt: examples: - '2025-01-01T00:00:00Z' format: date-time type: - string - 'null' document: examples: - '91315026015' maxLength: 100 type: string externalId: examples: - G4K7N8M2 maxLength: 256 type: string id: examples: - 00000000-0000-0000-0000-000000000000 format: uuid type: string legalPerson: $ref: '#/components/schemas/LegalPerson' metadata: additionalProperties: {} type: object name: examples: - John Doe maxLength: 256 type: string naturalPerson: $ref: '#/components/schemas/NaturalPerson' type: examples: - NATURAL_PERSON maxLength: 100 type: string updatedAt: examples: - '2025-01-01T00:00:00Z' format: date-time type: string required: - createdAt - updatedAt - deletedAt type: object Error: additionalProperties: false properties: code: description: >- Código de error de dominio estable y legible por máquina, acotado al servicio que lo emite (formato: -NNNN). examples: - ERR-0001 type: string detail: description: >- Una explicación legible por humanos específica de esta ocurrencia del problema. examples: - Property foo is required but is missing. type: string errors: description: Lista opcional de detalles de error individuales items: $ref: '#/components/schemas/ErrorDetail' type: - array - 'null' instance: description: >- Una referencia URI que identifica la ocurrencia específica del problema. examples: - https://example.com/error-log/abc123 format: uri type: string status: description: Código de estado HTTP examples: - 400 format: int64 type: integer title: description: >- Un resumen breve y legible por humanos del tipo de problema. Este valor no debería cambiar entre distintas ocurrencias del error. examples: - Bad Request type: string type: default: about:blank description: >- Una referencia URI a documentación legible por humanos sobre el error. examples: - https://example.com/errors/example format: uri type: string type: object Addresses: additionalProperties: false properties: additional1: $ref: '#/components/schemas/Address' additional2: $ref: '#/components/schemas/Address' primary: $ref: '#/components/schemas/Address' type: object Contact: additionalProperties: false properties: mobilePhone: examples: - '+1555555555' maxLength: 32 type: string otherPhone: examples: - '+1555555555' maxLength: 32 type: string primaryEmail: examples: - john.doe@example.com maxLength: 256 type: string secondaryEmail: examples: - john.doe@example.com maxLength: 256 type: string type: object LegalPerson: additionalProperties: false properties: activity: examples: - Electronic devices development maxLength: 256 type: string foundingDate: examples: - '2025-01-01' format: date type: string representative: $ref: '#/components/schemas/Representative' size: examples: - Medium maxLength: 100 type: string status: examples: - Active maxLength: 100 type: string tradeName: examples: - Lerian Studio maxLength: 256 type: string type: examples: - Limited Liability maxLength: 100 type: string type: object NaturalPerson: additionalProperties: false properties: birthDate: examples: - '1990-01-01' format: date type: string civilStatus: examples: - Single maxLength: 100 type: string fatherName: examples: - John Doe maxLength: 256 type: string favoriteName: examples: - John maxLength: 256 type: string gender: examples: - Male maxLength: 100 type: string motherName: examples: - Jane Doe maxLength: 256 type: string nationality: examples: - Brazilian maxLength: 100 type: string socialName: examples: - John Doe maxLength: 256 type: string status: examples: - Active maxLength: 100 type: string type: object ErrorDetail: additionalProperties: false properties: location: description: >- Dónde ocurrió el error, p. ej. 'body.items[3].tags' o 'path.thing-id' type: string message: description: Texto del mensaje de error type: string value: description: El valor en la ubicación indicada type: object Address: additionalProperties: false properties: city: examples: - New York maxLength: 100 type: string country: examples: - US maxLength: 2 minLength: 2 type: string description: examples: - Home maxLength: 100 type: string line1: examples: - 123 Financial Avenue maxLength: 256 type: string line2: examples: - Suite 1500 maxLength: 256 type: - string - 'null' state: examples: - NY maxLength: 100 type: string zipCode: examples: - '10001' maxLength: 20 type: string required: - line1 - line2 - zipCode - city - state - country type: object Representative: additionalProperties: false properties: document: examples: - '91315026015' maxLength: 100 type: string email: examples: - john.doe@example.com maxLength: 256 type: string name: examples: - John Doe maxLength: 256 type: string role: examples: - CFO maxLength: 100 type: string type: object ````