# Obtener los detalles de una instantánea de préstamo

Obtén los detalles de una instantánea específica del historial de préstamos.

Endpoint: GET /loans/{id}
Version: 1.0.0
Security: ApiKeyAuth, ApiKeySecret

## Path parameters:

  - `id` (string, required)
    El identificador único creado por Belvo utilizado para referenciar el registro del historial de préstamos.
    Example: "7a8b9c0d-1e2f-3a4b-5c6d-7e8f9a0b1c2d"

## Response 200 fields (application/json):

  - `id` (string, required)
    El identificador único creado por Belvo utilizado para referenciar esta instantánea del historial de préstamos.

  - `loanId` (string)
    El identificador único creado por Belvo utilizado para referenciar la entidad del préstamo principal.

  - `customerId` (string, required)
    El identificador único creado por Belvo utilizado para referenciar al cliente.

  - `paymentMethodId` (string)
    El identificador único creado por Belvo utilizado para referenciar el método de pago asociado con este préstamo.

  - `merchantCustomerId` (string, required)
    Su identificador de cliente asignado por el comerciante.

  - `status` (string, required)
    El estado del préstamo. Puede ser:
  - active
    El préstamo está siendo rastreado actualmente para su cobro.
  - inactive
    El préstamo ya no está activo.
    Enum: "active", "inactive"

  - `principalAmount` (string, required)
    El monto principal.

  - `totalBalance` (string, required)
    El saldo total pendiente.

  - `targetCollectionDate` (string, required)
    La fecha en que Belvo intentará cobrar el pago, en formato YYYY-MM-DD. Esta fecha se establece como el día en que se realizó la solicitud inicialmente o para el siguiente día hábil.

  - `defaultDate` (string, required)
    La fecha en que el cliente incumplió con el préstamo, en formato YYYY-MM-DD.

  - `daysOverdue` (integer)
    El número de días que el préstamo está vencido.

  - `issueDate` (string)
    La fecha de emisión original, en formato YYYY-MM-DD.

  - `loanAmount` (string)
    El monto original del préstamo.

  - `interestAmount` (string)
    El monto de interés acumulado.

  - `feesAmount` (string)
    Las tarifas asociadas con el préstamo.

  - `latePaymentInterestAmount` (string)
    El interés acumulado debido a pagos atrasados.

  - `openingCommissionAmount` (string)
    La comisión de apertura cobrada por el préstamo.

  - `yearlyOrdinalInterestRate` (string)
    La tasa de interés anual, con hasta 4 decimales.

  - `customerSalary` (string)
    El salario del cliente.

  - `customerAddress` (string)
    La dirección del cliente.

  - `creditStatus` (string)
    El estado de crédito del préstamo. Puede ser uno de los siguientes:
  - past_due
    El pago está vencido.
  - restructured
    El préstamo ha sido reestructurado.
  - canceled
    El préstamo ha sido cancelado.
  - in_arrears
    El préstamo está en mora.
    Enum: "past_due", "restructured", "canceled", "in_arrears"

  - `paidInstallments` (integer)
    El número de cuotas ya pagadas.

  - `paidAmount` (string)
    El monto total ya pagado.

  - `lastPaymentDate` (string)
    La fecha del último pago.

  - `lastPaymentAmount` (string)
    El monto del último pago.

  - `mainPhoneNumber` (string)
    El número de teléfono principal del cliente.

  - `reference` (string)
    Su referencia para el préstamo.

  - `createdDate` (string, required)
    La marca de tiempo ISO-8601 cuando se creó la instantánea del préstamo en la base de datos de Belvo.

  - `lastUpdatedDate` (string, required)
    La marca de tiempo ISO-8601 cuando la instantánea del préstamo fue actualizada por última vez en la base de datos de Belvo.

## Response 400 fields (application/json):

  - `statusCode` (integer)
    El código de estado HTTP para este error.
    Example: 400

  - `error` (string)
    La descripción del código de estado HTTP para este error.
    Example: "Bad Request"

  - `message` (any)
    Una breve descripción del error, indicando qué está mal con la solicitud.
> Nota: Devolvemos una cadena o un arreglo de cadenas, dependiendo del/los error(es) de validación.

La descripción puede ser (entre otras):

  - id must be a UUID
  - Not enough balance
  - amount is not a valid decimal number.
  - currency must be one of the following values: cop, mxn, usd
  - reference must be a string
  - Customer not found for merchant
  - documentType is a required field
    Example: "id must be a UUID"

## Response 401 fields (application/json):

  - `statusCode` (integer)
    El código de estado HTTP para este error.
    Example: 401

  - `error` (string)
    La descripción del código de estado HTTP para este error.
    Example: "Unauthorized"

  - `message` (string)
    Una breve descripción del error, indicando qué está mal con la solicitud. En el caso de un error 401 Unauthorized, el mensaje es:

  - Unauthorized credentials
    Example: "Unauthorized credentials"

## Response 404 fields (application/json):

  - `statusCode` (integer)
    El código de estado HTTP para este error.
    Example: 404

  - `error` (string)
    La descripción del código de estado HTTP para este error.
    Example: "Not Found"

  - `message` (string)
    Una breve descripción del error, indicando qué está mal con la solicitud. La descripción puede ser (entre otras):

  - Payout Target not found
  - Payment method not found
  - Customer not found
    Example: "Payout Target not found"