> ## 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.

# Obtener la cuenta de préstamo activa

> Devuelve el modelo de lectura de detalle de la cuenta de préstamo activa. Un UUID mal formado produce 422 (error de schema), distinto del 404 cuando la cuenta no existe.



## OpenAPI

````yaml es/openapi/v3-current/lender.yaml get /api/v1/loan-accounts/{id}
openapi: 3.1.0
info:
  contact:
    email: contact@lerian.studio
    name: Lerian Studio
    url: https://lerian.studio
  description: Superficie OpenAPI 3.1 code-first del servicio Lender.
  license:
    name: Lerian Studio General License
  title: Lender API
  version: 1.0.0
servers:
  - url: https://lender.sandbox.lerian.net
security:
  - BearerAuth: []
tags:
  - description: >-
      Operaciones de contabilidad del ledger: entradas de journal y asientos de
      accrual para cuentas de préstamo.
    name: Accounting
  - description: >-
      Recepción y ciclo de vida de la solicitud de préstamo: envío, decisión y
      estado.
    name: LoanApplications
  - description: >-
      Catálogo de productos de préstamo: definición, versionado y activación de
      productos de crédito.
    name: LoanProducts
  - description: >-
      Operaciones de servicing de cuentas de préstamo: saldos, cronogramas y
      acciones a nivel de cuenta.
    name: Loan Accounts
  - description: >-
      Operaciones de lectura de servicing: cronogramas de reembolso y estado de
      servicing para cuentas de préstamo.
    name: Servicings
  - description: >-
      Operaciones de lectura del panel de cartera: vistas agregadas de cartera y
      de rendimiento.
    name: Dashboard
  - description: >-
      Registro de jurisdicciones: perfiles de jurisdicción soportados y sus
      capacidades.
    name: Jurisdictions
  - description: >-
      Operaciones de solicitud de préstamo específicas por jurisdicción
      (superficie de originación de Brasil).
    name: Loan Applications
  - description: >-
      Operaciones de cálculo de impuestos para crédito específico por
      jurisdicción (por ejemplo, IOF de Brasil).
    name: Tax
  - description: >-
      Operaciones de consignado privado de Brasil: originación de contrato
      (contratación activa) y ciclo de vida.
    name: Consignado
paths:
  /api/v1/loan-accounts/{id}:
    get:
      tags:
        - Loan Accounts
      summary: Obtener la cuenta de préstamo activa
      description: >-
        Devuelve el modelo de lectura de detalle de la cuenta de préstamo
        activa. Un UUID mal formado produce 422 (error de schema), distinto del
        404 cuando la cuenta no existe.
      operationId: getActiveLoanAccount
      parameters:
        - description: Loan account identifier (UUID).
          in: path
          name: id
          required: true
          schema:
            description: Loan account identifier (UUID).
            examples:
              - 550e8400-e29b-41d4-a716-446655440000
            format: uuid
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ActiveLoanAccountHumaBody'
          description: OK
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Detail'
          description: Error
components:
  schemas:
    ActiveLoanAccountHumaBody:
      additionalProperties: false
      properties:
        assignedOfficerId:
          description: Identifier of the loan officer assigned to service this account.
          examples:
            - 550e8400-e29b-41d4-a716-446655440003
          type: string
        borrowerId:
          description: Identifier of the borrower who holds this account.
          examples:
            - 550e8400-e29b-41d4-a716-446655440002
          type: string
        disbursementDate:
          description: ISO-8601 date of fund disbursement; omitted until disbursed.
          examples:
            - '2026-06-14'
          type: string
        jurisdictionCode:
          description: ISO 3166-1 jurisdiction code the account operates under (e.g. BR).
          examples:
            - BR
          type: string
        loanAccountId:
          description: Loan account UUID.
          examples:
            - 550e8400-e29b-41d4-a716-446655440000
          type: string
        loanApplicationId:
          description: Originating loan application UUID.
          examples:
            - 550e8400-e29b-41d4-a716-446655440001
          type: string
        openBalance:
          description: Total open balance including fees and penalties (2 d.p. string).
          examples:
            - '1450.00'
          type: string
        principalBalance:
          description: Outstanding principal balance (2 d.p. string).
          examples:
            - '1234.56'
          type: string
        profileVersion:
          description: Product profile version applied to this account.
          examples:
            - 1.0.0
          type: string
        status:
          description: Account lifecycle status (e.g. active, closed, in_arrears).
          examples:
            - active
          type: string
      required:
        - loanAccountId
        - loanApplicationId
        - status
        - principalBalance
        - openBalance
        - profileVersion
        - jurisdictionCode
        - borrowerId
        - assignedOfficerId
      type: object
    Detail:
      additionalProperties: false
      properties:
        code:
          description: >-
            Stable, machine-readable domain error code scoped to the emitting
            service (format: <SERVICE>-NNNN).
          examples:
            - ERR-0001
          type: string
        detail:
          description: >-
            A human-readable explanation specific to this occurrence of the
            problem.
          examples:
            - Property foo is required but is missing.
          type: string
        errors:
          description: Optional list of individual error details
          items:
            $ref: '#/components/schemas/ErrorDetail'
          type:
            - array
            - 'null'
        instance:
          description: >-
            A URI reference that identifies the specific occurrence of the
            problem.
          examples:
            - https://example.com/error-log/abc123
          format: uri
          type: string
        status:
          description: HTTP status code
          examples:
            - 400
          format: int64
          type: integer
        title:
          description: >-
            A short, human-readable summary of the problem type. This value
            should not change between occurrences of the error.
          examples:
            - Bad Request
          type: string
        type:
          default: about:blank
          description: A URI reference to human-readable documentation for the error.
          examples:
            - https://example.com/errors/example
          format: uri
          type: string
      type: object
    ErrorDetail:
      additionalProperties: false
      properties:
        location:
          description: >-
            Where the error occurred, e.g. 'body.items[3].tags' or
            'path.thing-id'
          type: string
        message:
          description: Error message text
          type: string
        value:
          description: The value at the given location
      type: object
  securitySchemes:
    BearerAuth:
      bearerFormat: JWT
      description: JWT bearer token issued by the identity provider.
      scheme: bearer
      type: http

````