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": "BRL",
  "jurisdictionCode": "BR",
  "rateBand": {
    "maxAnnualRateBps": 4800,
    "minAnnualRateBps": 1200
  },
  "admittedBorrowerKinds": [
    "pessoaFisica"
  ],
  "fixedAnnualRateBps": 1850,
  "floatingRateTableId": "550e8400-e29b-41d4-a716-446655440002",
  "floatingSpreadBps": 1850,
  "jurisdictionExtensions": {},
  "rateMode": "fixed",
  "requiresFloatingRate": true
}
'

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\": \"BRL\",\n  \"jurisdictionCode\": \"BR\",\n  \"rateBand\": {\n    \"maxAnnualRateBps\": 4800,\n    \"minAnnualRateBps\": 1200\n  },\n  \"admittedBorrowerKinds\": [\n    \"pessoaFisica\"\n  ],\n  \"fixedAnnualRateBps\": 1850,\n  \"floatingRateTableId\": \"550e8400-e29b-41d4-a716-446655440002\",\n  \"floatingSpreadBps\": 1850,\n  \"jurisdictionExtensions\": {},\n  \"rateMode\": \"fixed\",\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))

}

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    changeReason: '<string>',
    currency: 'BRL',
    jurisdictionCode: 'BR',
    rateBand: {maxAnnualRateBps: 4800, minAnnualRateBps: 1200},
    admittedBorrowerKinds: ['pessoaFisica'],
    fixedAnnualRateBps: 1850,
    floatingRateTableId: '550e8400-e29b-41d4-a716-446655440002',
    floatingSpreadBps: 1850,
    jurisdictionExtensions: {},
    rateMode: 'fixed',
    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));

import requests

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

payload = {
    "changeReason": "<string>",
    "currency": "BRL",
    "jurisdictionCode": "BR",
    "rateBand": {
        "maxAnnualRateBps": 4800,
        "minAnnualRateBps": 1200
    },
    "admittedBorrowerKinds": ["pessoaFisica"],
    "fixedAnnualRateBps": 1850,
    "floatingRateTableId": "550e8400-e29b-41d4-a716-446655440002",
    "floatingSpreadBps": 1850,
    "jurisdictionExtensions": {},
    "rateMode": "fixed",
    "requiresFloatingRate": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "accrualBasis": "effective_interest",
  "admittedBorrowerKinds": [
    "pessoaFisica"
  ],
  "changeReason": "<string>",
  "createdAt": "2026-06-14T12:00:00Z",
  "currency": "BRL",
  "fixedAnnualRateBps": 1850,
  "floatingSpreadBps": 1850,
  "id": "550e8400-e29b-41d4-a716-446655440001",
  "jurisdictionCode": "BR",
  "productId": "550e8400-e29b-41d4-a716-446655440000",
  "rateMode": "fixed",
  "requiresFloatingRate": true,
  "firstDueDateWindow": {
    "maxDays": 45,
    "minDays": 15
  },
  "floatingRateTableId": "550e8400-e29b-41d4-a716-446655440002",
  "jurisdictionExtensions": {},
  "rateBand": {
    "maxAnnualRateBps": 4800,
    "minAnnualRateBps": 1200
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

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": "BRL",
  "jurisdictionCode": "BR",
  "rateBand": {
    "maxAnnualRateBps": 4800,
    "minAnnualRateBps": 1200
  },
  "admittedBorrowerKinds": [
    "pessoaFisica"
  ],
  "fixedAnnualRateBps": 1850,
  "floatingRateTableId": "550e8400-e29b-41d4-a716-446655440002",
  "floatingSpreadBps": 1850,
  "jurisdictionExtensions": {},
  "rateMode": "fixed",
  "requiresFloatingRate": true
}
'

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\": \"BRL\",\n  \"jurisdictionCode\": \"BR\",\n  \"rateBand\": {\n    \"maxAnnualRateBps\": 4800,\n    \"minAnnualRateBps\": 1200\n  },\n  \"admittedBorrowerKinds\": [\n    \"pessoaFisica\"\n  ],\n  \"fixedAnnualRateBps\": 1850,\n  \"floatingRateTableId\": \"550e8400-e29b-41d4-a716-446655440002\",\n  \"floatingSpreadBps\": 1850,\n  \"jurisdictionExtensions\": {},\n  \"rateMode\": \"fixed\",\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))

}

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    changeReason: '<string>',
    currency: 'BRL',
    jurisdictionCode: 'BR',
    rateBand: {maxAnnualRateBps: 4800, minAnnualRateBps: 1200},
    admittedBorrowerKinds: ['pessoaFisica'],
    fixedAnnualRateBps: 1850,
    floatingRateTableId: '550e8400-e29b-41d4-a716-446655440002',
    floatingSpreadBps: 1850,
    jurisdictionExtensions: {},
    rateMode: 'fixed',
    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));

import requests

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

payload = {
    "changeReason": "<string>",
    "currency": "BRL",
    "jurisdictionCode": "BR",
    "rateBand": {
        "maxAnnualRateBps": 4800,
        "minAnnualRateBps": 1200
    },
    "admittedBorrowerKinds": ["pessoaFisica"],
    "fixedAnnualRateBps": 1850,
    "floatingRateTableId": "550e8400-e29b-41d4-a716-446655440002",
    "floatingSpreadBps": 1850,
    "jurisdictionExtensions": {},
    "rateMode": "fixed",
    "requiresFloatingRate": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "accrualBasis": "effective_interest",
  "admittedBorrowerKinds": [
    "pessoaFisica"
  ],
  "changeReason": "<string>",
  "createdAt": "2026-06-14T12:00:00Z",
  "currency": "BRL",
  "fixedAnnualRateBps": 1850,
  "floatingSpreadBps": 1850,
  "id": "550e8400-e29b-41d4-a716-446655440001",
  "jurisdictionCode": "BR",
  "productId": "550e8400-e29b-41d4-a716-446655440000",
  "rateMode": "fixed",
  "requiresFloatingRate": true,
  "firstDueDateWindow": {
    "maxDays": 45,
    "minDays": 15
  },
  "floatingRateTableId": "550e8400-e29b-41d4-a716-446655440002",
  "jurisdictionExtensions": {},
  "rateBand": {
    "maxAnnualRateBps": 4800,
    "minAnnualRateBps": 1200
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

Autorizaciones

Authorization

string

header

requerido

JWT bearer token issued by the identity provider.

Parámetros de ruta

string<uuid>

requerido

Loan product identifier.

Cuerpo

application/json

changeReason

string

requerido

Reason for the new version.

currency

string

requerido

ISO 4217 currency code the product version denominates (3 uppercase letters); the loan's currency source of truth.

Required string length: 3

Ejemplo:

"BRL"

jurisdictionCode

string

requerido

Jurisdiction profile code.

Ejemplo:

"BR"

rateBand

object

requerido

Price band this version authorizes, in annual basis points. Required: a version declaring no band originates nothing. A pointer so an omitted band is refused instead of defaulting to a zero-to-zero band that authorizes only a 0% rate.

Show child attributes

admittedBorrowerKinds

enum<string>[] | null

Kinds of borrower this version will originate for. Omitting it, or sending an empty list, declares NOTHING and admits NOBODY — it does not mean "both". Brazil taxes the two kinds at different IOF rates (Decreto 6.306/2007, art. 7o, I, "b"), so a product that has not said whose credit it grants cannot be priced. Duplicates are collapsed and the set is stored sorted; any other value is refused with 422.

Maximum array length: 2

Opciones disponibles:

pessoaFisica,

pessoaJuridica

Ejemplo:

["pessoaFisica"]

firstDueDateWindow

object

Span of days after the money date in which this version admits a CHOSEN first instalment date. OPTIONAL, unlike the price band: omit it and the version bounds no chosen date, which is how every product that takes the generator's monthly grid behaves. Omitted is not a window of zero.

Show child attributes

fixedAnnualRateBps

integer<int64>

Fixed annual rate in basis points.

Ejemplo:

1850

floatingRateTableId

string

Floating-rate table identifier.

Ejemplo:

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

floatingSpreadBps

integer<int64>

Floating spread in basis points.

Ejemplo:

1850

jurisdictionExtensions

object

Opaque per-jurisdiction version fields.

rateMode

string

Rate mode (fixed|floating).

Ejemplo:

"fixed"

requiresFloatingRate

boolean

Whether a floating-rate table is required.

Respuesta

Created

accrualBasis

string

requerido

Interest recognition method the servicing accrual engine applies (effective_interest|linear).

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"

fixedAnnualRateBps

integer<int64>

requerido

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

Ejemplo:

1850

floatingSpreadBps

integer<int64>

requerido

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

Ejemplo:

1850

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.

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.

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 annual basis points. Absent only on a stored version that predates the band; such a version originates nothing.

Show child attributes

Productos de préstamo de Brasil

Operaciones de consignado

Ciclo de vida del producto

Versiones del producto

Configuración del producto

Tablas de tasa flotante

Plantillas de documento

Solicitudes de Préstamo

Instrumentos de crédito

Divulgaciones regulatorias y riesgo

Liquidación y prepago

Resumen y auditoría de cuenta

Cargos y calendario

Pagos

Transacciones

Cuentas por cobrar de pago devuelto

Fondos de cesión

Lotes de cesión

Excepciones y registradora de la cesión

Contabilidad

Paneles de cartera

Jurisdicciones

Impuestos

Sesión

Streaming

Manejo de errores

Eventos

Create loan product version

Autorizaciones

Parámetros de ruta

Cuerpo

Respuesta