Get loan product version

Returns one immutable product version snapshot by its own identifier.

GET /api/v1/loan-product-versions/{id}

Get loan product version

cURL

curl --request GET \
  --url https://lender.sandbox.lerian.net/api/v1/loan-product-versions/{id} \
  --header 'Authorization: Bearer <token>'

200

{
  "accrualBasis": "effective_interest",
  "admittedBorrowerKinds": [
    "pessoaFisica"
  ],
  "changeReason": "<string>",
  "createdAt": "2026-06-14T12:00:00Z",
  "currency": "BRL",
  "fixedMonthlyRate": "0.01800000",
  "floatingSpreadBps": 1850,
  "id": "550e8400-e29b-41d4-a716-446655440001",
  "jurisdictionCode": "BR",
  "productId": "550e8400-e29b-41d4-a716-446655440000",
  "rateMode": "fixed",
  "requiresFloatingRate": true,
  "terms": {
    "admitsAssignment": true,
    "amortizationSystems": [
      "price"
    ],
    "amountAnchors": [
      "gross"
    ],
    "creditInstrumentMode": "lender_emitted",
    "dayCount": "monthly_30",
    "latePayment": {
      "defaultInterestMonthly": "0.01",
      "finePct": "0.02",
      "graceDays": 0
    },
    "limits": {
      "maxInstallments": 48,
      "maxPrincipal": "50000.00",
      "maxTermMonths": 48,
      "minInstallments": 1,
      "minPrincipal": "100.00",
      "minTermMonths": 1
    },
    "originationFronts": [
      "gateway_clt",
      "lender_direct"
    ],
    "paymentPeriodicities": [
      "monthly"
    ],
    "paymentRuleKinds": [
      "interestOnly"
    ],
    "payoffQuoteValidityHours": 24,
    "prepaymentMode": "desk",
    "refinance": {
      "ratePolicy": "lower_than_weighted_average"
    },
    "releaseRequiresSignedInstrument": true
  },
  "firstDueDateWindow": {
    "maxDays": 45,
    "minDays": 15
  },
  "floatingRateTableId": "550e8400-e29b-41d4-a716-446655440002",
  "jurisdictionExtensions": {},
  "rateBand": {
    "maxAnnualRateBps": 4800,
    "minAnnualRateBps": 1200
  }
}

Autorizaciones

Authorization · string · header · requerido

JWT bearer token issued by the identity provider.

Parámetros de ruta

id · string<uuid> · requerido

Product version snapshot identifier.

Respuesta

200

application/json

OK

accrualBasis · string · requerido

Interest recognition method the servicing accrual engine applies; always effective_interest.

Ejemplo:

"effective_interest"

admittedBorrowerKinds · string[] · requerido

Kinds of borrower this version will originate for, de-duplicated and sorted. An EMPTY list means the version declares nothing and admits nobody; it never means "both".

Ejemplo:

["pessoaFisica"]

changeReason · string · requerido

Reason recorded for creating this version.

createdAt · string · requerido

Creation timestamp (RFC3339, UTC).

Ejemplo:

"2026-06-14T12:00:00Z"

currency · string · requerido

ISO 4217 currency code the product version denominates (3 uppercase letters).

Ejemplo:

"BRL"

fixedMonthlyRate · string · requerido

Fixed MONTHLY interest rate as a decimal fraction, scale 8 (0.018 is 1.80% a month); the rate band is effective annual, checked as (1+rate)^12-1.

Ejemplo:

"0.01800000"

floatingSpreadBps · integer<int64> · requerido

Floating spread in basis points (1 bps = 0.01%).

Ejemplo:

1850

id · string · requerido

Server-assigned version identifier (uuid).

Ejemplo:

"550e8400-e29b-41d4-a716-446655440001"

jurisdictionCode · string · requerido

Jurisdiction profile code (e.g. BR).

Ejemplo:

"BR"

productId · string · requerido

Owning loan product identifier (uuid).

Ejemplo:

"550e8400-e29b-41d4-a716-446655440000"

rateMode · string · requerido

Rate mode (fixed|floating).

Ejemplo:

"fixed"

requiresFloatingRate · boolean · requerido

Whether a floating-rate table is required for this version.

terms · object · requerido

What the version admits.

Show child attributes

firstDueDateWindow · object

Span of days after the money date in which this version admits a chosen first instalment date. Absent means the version bounds no chosen date, which is the ordinary case. It also bounds a release on another day than the application expected: the span from the money day to the application's recorded first due date must fall inside it.

Show child attributes

floatingRateTableId · string

Linked floating-rate table identifier (uuid); empty in fixed mode.

Ejemplo:

"550e8400-e29b-41d4-a716-446655440002"

jurisdictionExtensions · object

Opaque per-jurisdiction version fields, echoed from the request for traceability.

rateBand · object

Price band this version authorizes, in effective annual basis points. Absent only on a stored version that predates the band; such a version originates nothing.

Show child attributes