Price the tenant's IOF for one borrower kind

curl --request PUT \
  --url https://lender.sandbox.lerian.net/api/v1/br/tax/iof-rates/{borrowerKind} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "additionalPercent": "0.38",
  "dailyPercent": "0.0082",
  "sourceReference": "Decreto 6.306/2007, art. 7, I, b, 1, redação do Decreto 12.499/2025; ADC 96 cautelar em vigor",
  "changedBy": "tax-desk"
}
'

package main

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

func main() {

	url := "https://lender.sandbox.lerian.net/api/v1/br/tax/iof-rates/{borrowerKind}"

	payload := strings.NewReader("{\n  \"additionalPercent\": \"0.38\",\n  \"dailyPercent\": \"0.0082\",\n  \"sourceReference\": \"Decreto 6.306/2007, art. 7, I, b, 1, redação do Decreto 12.499/2025; ADC 96 cautelar em vigor\",\n  \"changedBy\": \"tax-desk\"\n}")

	req, _ := http.NewRequest("PUT", 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: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    additionalPercent: '0.38',
    dailyPercent: '0.0082',
    sourceReference: 'Decreto 6.306/2007, art. 7, I, b, 1, redação do Decreto 12.499/2025; ADC 96 cautelar em vigor',
    changedBy: 'tax-desk'
  })
};

fetch('https://lender.sandbox.lerian.net/api/v1/br/tax/iof-rates/{borrowerKind}', 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/br/tax/iof-rates/{borrowerKind}"

payload = {
    "additionalPercent": "0.38",
    "dailyPercent": "0.0082",
    "sourceReference": "Decreto 6.306/2007, art. 7, I, b, 1, redação do Decreto 12.499/2025; ADC 96 cautelar em vigor",
    "changedBy": "tax-desk"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "changedBy": "<string>",
  "effectiveFrom": "2023-11-07T05:31:56Z",
  "rateTableSnapshotId": "br-tax-rates-v1",
  "rates": [
    {
      "additionalPercent": "0.38",
      "borrowerKind": "pessoaJuridica",
      "dailyPercent": "0.0082",
      "dayCap": 365
    }
  ],
  "sourceReference": "<string>"
}

{
  "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"
  }
}

{
  "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"
  }
}

PUT

api

tax

iof-rates

{borrowerKind}

Price the tenant's IOF for one borrower kind

curl --request PUT \
  --url https://lender.sandbox.lerian.net/api/v1/br/tax/iof-rates/{borrowerKind} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "additionalPercent": "0.38",
  "dailyPercent": "0.0082",
  "sourceReference": "Decreto 6.306/2007, art. 7, I, b, 1, redação do Decreto 12.499/2025; ADC 96 cautelar em vigor",
  "changedBy": "tax-desk"
}
'

package main

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

func main() {

	url := "https://lender.sandbox.lerian.net/api/v1/br/tax/iof-rates/{borrowerKind}"

	payload := strings.NewReader("{\n  \"additionalPercent\": \"0.38\",\n  \"dailyPercent\": \"0.0082\",\n  \"sourceReference\": \"Decreto 6.306/2007, art. 7, I, b, 1, redação do Decreto 12.499/2025; ADC 96 cautelar em vigor\",\n  \"changedBy\": \"tax-desk\"\n}")

	req, _ := http.NewRequest("PUT", 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: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    additionalPercent: '0.38',
    dailyPercent: '0.0082',
    sourceReference: 'Decreto 6.306/2007, art. 7, I, b, 1, redação do Decreto 12.499/2025; ADC 96 cautelar em vigor',
    changedBy: 'tax-desk'
  })
};

fetch('https://lender.sandbox.lerian.net/api/v1/br/tax/iof-rates/{borrowerKind}', 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/br/tax/iof-rates/{borrowerKind}"

payload = {
    "additionalPercent": "0.38",
    "dailyPercent": "0.0082",
    "sourceReference": "Decreto 6.306/2007, art. 7, I, b, 1, redação do Decreto 12.499/2025; ADC 96 cautelar em vigor",
    "changedBy": "tax-desk"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "changedBy": "<string>",
  "effectiveFrom": "2023-11-07T05:31:56Z",
  "rateTableSnapshotId": "br-tax-rates-v1",
  "rates": [
    {
      "additionalPercent": "0.38",
      "borrowerKind": "pessoaJuridica",
      "dailyPercent": "0.0082",
      "dayCap": 365
    }
  ],
  "sourceReference": "<string>"
}

{
  "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"
  }
}

{
  "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"
  }
}

Authorizations

Authorization

string

header

required

JWT bearer token issued by the identity provider.

Path Parameters

borrowerKind

enum<string>

required

The rate-table key a disbursement reads: the borrower kind, or simplesNacional for a pessoa jurídica under the Simples Nacional regime whose operation is R$ 30.000,00 or less (Decreto 6.306/2007, art. 7, VI).

Available options:

pessoaFisica,

pessoaJuridica,

simplesNacional

Example:

"pessoaJuridica"

Body

application/json

additionalPercent

string

required

One-off additional alíquota of art. 7, § 15, in percent: 0.38 is 0,38%. Above 1.5 is LENDER-0935; a sign or more than 6 decimals is refused by the schema.

Pattern: ^[0-9]{1,2}(\.[0-9]{1,6})?$

Example:

"0.38"

dailyPercent

string

required

Daily alíquota in percent, as the decree writes it: 0.0082 is 0,0082% ao dia. Above 1.5, the maximum of art. 6, is LENDER-0935; a sign or more than 6 decimals is refused by the schema.

Pattern: ^[0-9]{1,2}(\.[0-9]{1,6})?$

Example:

"0.0082"

sourceReference

string

required

The legal basis of the rate, kept with it.

Maximum string length: 512

Pattern: \S

Example:

"Decreto 6.306/2007, art. 7, I, b, 1, redação do Decreto 12.499/2025; ADC 96 cautelar em vigor"

changedBy

string

Who makes the change, read only when the deployment runs without authentication; an authenticated subject always wins. A change naming nobody is refused LENDER-0941.

Maximum string length: 256

Example:

"tax-desk"

Response

changedBy

string

required

Who priced the version; empty for the version the deployment shipped.

effectiveFrom

string<date-time>

required

When the version came into force.

rateTableSnapshotId

string

required

The version a disbursement made now pins.

Example:

"br-tax-rates-v1"

rates

object[] | null

required

The kinds priced, sorted by key. A kind absent here is refused: LENDER-0233 at disbursement, LENDER-0900 at the tax preview.

Show child attributes

sourceReference

string

required

The legal basis cited; empty for the version the deployment shipped.

Brazil loan products

Consignado operations

Loan product lifecycle

Product versions

Product configuration

Floating-rate tables

Document templates

Loan Applications

Credit instruments

Regulatory disclosures and risk

Payoff and prepayment

Write-offs and credit-loss recovery

Account overview and audit

Charges and schedule

Repayments

Transactions

Returned payment receivables

Assignment funds

Assignment sets

Assignment exceptions and dossiers

Accounting

Portfolio dashboards

Jurisdictions

Tax

Partner access

Session

Business date

Streaming

Error handling

Events

Price the tenant's IOF for one borrower kind

Authorizations

Path Parameters

Body

Response