Create loan product version

curl --request POST \
  --url https://lender.sandbox.lerian.net/api/v1/loan-products/{id}/versions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "changeReason": "<string>",
  "currency": "<string>",
  "jurisdictionCode": "<string>",
  "fixedAnnualRateBps": 123,
  "floatingRateTableId": "<string>",
  "floatingSpreadBps": 123,
  "jurisdictionExtensions": {},
  "rateMode": "<string>",
  "requiresFloatingRate": true
}
'

import requests

url = "https://lender.sandbox.lerian.net/api/v1/loan-products/{id}/versions"

payload = {
    "changeReason": "<string>",
    "currency": "<string>",
    "jurisdictionCode": "<string>",
    "fixedAnnualRateBps": 123,
    "floatingRateTableId": "<string>",
    "floatingSpreadBps": 123,
    "jurisdictionExtensions": {},
    "rateMode": "<string>",
    "requiresFloatingRate": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    changeReason: '<string>',
    currency: '<string>',
    jurisdictionCode: '<string>',
    fixedAnnualRateBps: 123,
    floatingRateTableId: '<string>',
    floatingSpreadBps: 123,
    jurisdictionExtensions: {},
    rateMode: '<string>',
    requiresFloatingRate: true
  })
};

fetch('https://lender.sandbox.lerian.net/api/v1/loan-products/{id}/versions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://lender.sandbox.lerian.net/api/v1/loan-products/{id}/versions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'changeReason' => '<string>',
    'currency' => '<string>',
    'jurisdictionCode' => '<string>',
    'fixedAnnualRateBps' => 123,
    'floatingRateTableId' => '<string>',
    'floatingSpreadBps' => 123,
    'jurisdictionExtensions' => [
        
    ],
    'rateMode' => '<string>',
    'requiresFloatingRate' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://lender.sandbox.lerian.net/api/v1/loan-products/{id}/versions"

	payload := strings.NewReader("{\n  \"changeReason\": \"<string>\",\n  \"currency\": \"<string>\",\n  \"jurisdictionCode\": \"<string>\",\n  \"fixedAnnualRateBps\": 123,\n  \"floatingRateTableId\": \"<string>\",\n  \"floatingSpreadBps\": 123,\n  \"jurisdictionExtensions\": {},\n  \"rateMode\": \"<string>\",\n  \"requiresFloatingRate\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://lender.sandbox.lerian.net/api/v1/loan-products/{id}/versions")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"changeReason\": \"<string>\",\n  \"currency\": \"<string>\",\n  \"jurisdictionCode\": \"<string>\",\n  \"fixedAnnualRateBps\": 123,\n  \"floatingRateTableId\": \"<string>\",\n  \"floatingSpreadBps\": 123,\n  \"jurisdictionExtensions\": {},\n  \"rateMode\": \"<string>\",\n  \"requiresFloatingRate\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://lender.sandbox.lerian.net/api/v1/loan-products/{id}/versions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"changeReason\": \"<string>\",\n  \"currency\": \"<string>\",\n  \"jurisdictionCode\": \"<string>\",\n  \"fixedAnnualRateBps\": 123,\n  \"floatingRateTableId\": \"<string>\",\n  \"floatingSpreadBps\": 123,\n  \"jurisdictionExtensions\": {},\n  \"rateMode\": \"<string>\",\n  \"requiresFloatingRate\": true\n}"

response = http.request(request)
puts response.read_body

{
  "changeReason": "<string>",
  "createdAt": "<string>",
  "currency": "<string>",
  "fixedAnnualRateBps": 123,
  "floatingSpreadBps": 123,
  "id": "<string>",
  "jurisdictionCode": "<string>",
  "productId": "<string>",
  "rateMode": "<string>",
  "requiresFloatingRate": true,
  "floatingRateTableId": "<string>",
  "jurisdictionExtensions": {}
}

{
  "code": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "about:blank",
  "upstream": {
    "code": "<string>",
    "message": "<string>"
  }
}

POST

api

loan-products

{id}

versions

Create loan product version

curl --request POST \
  --url https://lender.sandbox.lerian.net/api/v1/loan-products/{id}/versions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "changeReason": "<string>",
  "currency": "<string>",
  "jurisdictionCode": "<string>",
  "fixedAnnualRateBps": 123,
  "floatingRateTableId": "<string>",
  "floatingSpreadBps": 123,
  "jurisdictionExtensions": {},
  "rateMode": "<string>",
  "requiresFloatingRate": true
}
'

import requests

url = "https://lender.sandbox.lerian.net/api/v1/loan-products/{id}/versions"

payload = {
    "changeReason": "<string>",
    "currency": "<string>",
    "jurisdictionCode": "<string>",
    "fixedAnnualRateBps": 123,
    "floatingRateTableId": "<string>",
    "floatingSpreadBps": 123,
    "jurisdictionExtensions": {},
    "rateMode": "<string>",
    "requiresFloatingRate": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    changeReason: '<string>',
    currency: '<string>',
    jurisdictionCode: '<string>',
    fixedAnnualRateBps: 123,
    floatingRateTableId: '<string>',
    floatingSpreadBps: 123,
    jurisdictionExtensions: {},
    rateMode: '<string>',
    requiresFloatingRate: true
  })
};

fetch('https://lender.sandbox.lerian.net/api/v1/loan-products/{id}/versions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://lender.sandbox.lerian.net/api/v1/loan-products/{id}/versions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'changeReason' => '<string>',
    'currency' => '<string>',
    'jurisdictionCode' => '<string>',
    'fixedAnnualRateBps' => 123,
    'floatingRateTableId' => '<string>',
    'floatingSpreadBps' => 123,
    'jurisdictionExtensions' => [
        
    ],
    'rateMode' => '<string>',
    'requiresFloatingRate' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://lender.sandbox.lerian.net/api/v1/loan-products/{id}/versions"

	payload := strings.NewReader("{\n  \"changeReason\": \"<string>\",\n  \"currency\": \"<string>\",\n  \"jurisdictionCode\": \"<string>\",\n  \"fixedAnnualRateBps\": 123,\n  \"floatingRateTableId\": \"<string>\",\n  \"floatingSpreadBps\": 123,\n  \"jurisdictionExtensions\": {},\n  \"rateMode\": \"<string>\",\n  \"requiresFloatingRate\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://lender.sandbox.lerian.net/api/v1/loan-products/{id}/versions")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"changeReason\": \"<string>\",\n  \"currency\": \"<string>\",\n  \"jurisdictionCode\": \"<string>\",\n  \"fixedAnnualRateBps\": 123,\n  \"floatingRateTableId\": \"<string>\",\n  \"floatingSpreadBps\": 123,\n  \"jurisdictionExtensions\": {},\n  \"rateMode\": \"<string>\",\n  \"requiresFloatingRate\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://lender.sandbox.lerian.net/api/v1/loan-products/{id}/versions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"changeReason\": \"<string>\",\n  \"currency\": \"<string>\",\n  \"jurisdictionCode\": \"<string>\",\n  \"fixedAnnualRateBps\": 123,\n  \"floatingRateTableId\": \"<string>\",\n  \"floatingSpreadBps\": 123,\n  \"jurisdictionExtensions\": {},\n  \"rateMode\": \"<string>\",\n  \"requiresFloatingRate\": true\n}"

response = http.request(request)
puts response.read_body

{
  "changeReason": "<string>",
  "createdAt": "<string>",
  "currency": "<string>",
  "fixedAnnualRateBps": 123,
  "floatingSpreadBps": 123,
  "id": "<string>",
  "jurisdictionCode": "<string>",
  "productId": "<string>",
  "rateMode": "<string>",
  "requiresFloatingRate": true,
  "floatingRateTableId": "<string>",
  "jurisdictionExtensions": {}
}

{
  "code": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "about:blank",
  "upstream": {
    "code": "<string>",
    "message": "<string>"
  }
}

Authorizations

Authorization

string

header

required

JWT bearer token issued by the identity provider.

Path Parameters

string<uuid>

required

Loan product identifier.

Body

application/json

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.

Required string length: 3

Example:

"BRL"

jurisdictionCode

string

required

Jurisdiction profile code.

Example:

"BR"

fixedAnnualRateBps

integer<int64>

Fixed annual rate in basis points.

Example:

1850

floatingRateTableId

string

Floating-rate table identifier.

Example:

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

floatingSpreadBps

integer<int64>

Floating spread in basis points.

Example:

1850

jurisdictionExtensions

object

Opaque per-jurisdiction version fields.

rateMode

string

Rate mode (fixed|floating).

Example:

"fixed"

requiresFloatingRate

boolean

Whether a floating-rate table is required.

Response

Created

changeReason

string

required

Reason recorded for creating this version.

createdAt

string

required

Creation timestamp (RFC3339, UTC).

Example:

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

currency

string

required

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

Example:

"BRL"

fixedAnnualRateBps

integer<int64>

required

Fixed annual rate in basis points (1 bps = 0.01%).

Example:

1850

floatingSpreadBps

integer<int64>

required

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

Example:

1850

string

required

Server-assigned version identifier (uuid).

Example:

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

jurisdictionCode

string

required

Jurisdiction profile code (e.g. BR).

Example:

"BR"

productId

string

required

Owning loan product identifier (uuid).

Example:

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

rateMode

string

required

Rate mode (fixed|floating).

Example:

"fixed"

requiresFloatingRate

boolean

required

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

floatingRateTableId

string

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

Example:

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

jurisdictionExtensions

object

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

⌘I

Brazil loan products

Consignado operations

Loan product lifecycle

Product configuration

Loan Applications

Regulatory disclosures and risk

Payoff and prepayment

Account overview and audit

Charges and schedule

Repayments

Transactions

Accounting

Jurisdictions

Tax

Create loan product version

Authorizations

Path Parameters

Body

Response