---
title: "Create loan product version"
method: POST
path: "/api/v1/loan-products/{id}/versions"
tags: ["LoanProducts"]
---

# Create loan product version

`POST /api/v1/loan-products/{id}/versions`

Creates a new version snapshot of a loan product with updated regulatory parameters.

## Path parameters

- `id` string, uuid, required — Loan product identifier.

## Request body

- CreateLoanProductVersionHumaInputBody
  - `changeReason` string, required — Reason for the new version.
  - `currency` string, required — ISO 4217 currency code the product version denominates (3 uppercase letters); the loan's currency source of truth.
  - `fixedAnnualRateBps` integer — Fixed annual rate in basis points.
  - `floatingRateTableId` string — Floating-rate table identifier.
  - `floatingSpreadBps` integer — Floating spread in basis points.
  - `jurisdictionCode` string, required — Jurisdiction profile code.
  - `jurisdictionExtensions` object — Opaque per-jurisdiction version fields.
  - `rateMode` string — Rate mode (fixed|floating).
  - `requiresFloatingRate` boolean — Whether a floating-rate table is required.

## Response `201`

Created

- LoanProductVersionHumaBody
  - `changeReason` string, required — Reason recorded for creating this version.
  - `createdAt` string, required — Creation timestamp (RFC3339, UTC).
  - `currency` string, required — ISO 4217 currency code the product version denominates (3 uppercase letters).
  - `fixedAnnualRateBps` integer, required — Fixed annual rate in basis points (1 bps = 0.01%).
  - `floatingRateTableId` string — Linked floating-rate table identifier (uuid); empty in fixed mode.
  - `floatingSpreadBps` integer, required — Floating spread in basis points (1 bps = 0.01%).
  - `id` string, required — Server-assigned version identifier (uuid).
  - `jurisdictionCode` string, required — Jurisdiction profile code (e.g. BR).
  - `jurisdictionExtensions` object — Opaque per-jurisdiction version fields, echoed from the request for traceability.
  - `productId` string, required — Owning loan product identifier (uuid).
  - `rateMode` string, required — Rate mode (fixed|floating).
  - `requiresFloatingRate` boolean, required — Whether a floating-rate table is required for this version.

## Other responses

- `default` — Error

---

[API](https://skmtc.net/lerian/apis/identity-plugin.md) · [All operations](https://skmtc.net/lerian/apis/identity-plugin/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lerian/identity-plugin/versions/25daba385532/schema)