Disburse loan application

curl --request POST \
  --url https://lender.sandbox.lerian.net/api/v1/loan-applications/{id}/disburse \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Idempotency: <x-idempotency>' \
  --data '
{
  "disbursedAt": "<string>",
  "grossRequestedAmount": "<string>",
  "loanAccountId": "<string>",
  "netDeliveredAmount": "<string>",
  "currency": "<string>",
  "jurisdictionExtensions": {},
  "originationFeeAmount": "<string>"
}
'

import requests

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

payload = {
    "disbursedAt": "<string>",
    "grossRequestedAmount": "<string>",
    "loanAccountId": "<string>",
    "netDeliveredAmount": "<string>",
    "currency": "<string>",
    "jurisdictionExtensions": {},
    "originationFeeAmount": "<string>"
}
headers = {
    "X-Idempotency": "<x-idempotency>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'X-Idempotency': '<x-idempotency>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    disbursedAt: '<string>',
    grossRequestedAmount: '<string>',
    loanAccountId: '<string>',
    netDeliveredAmount: '<string>',
    currency: '<string>',
    jurisdictionExtensions: {},
    originationFeeAmount: '<string>'
  })
};

fetch('https://lender.sandbox.lerian.net/api/v1/loan-applications/{id}/disburse', 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-applications/{id}/disburse",
  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([
    'disbursedAt' => '<string>',
    'grossRequestedAmount' => '<string>',
    'loanAccountId' => '<string>',
    'netDeliveredAmount' => '<string>',
    'currency' => '<string>',
    'jurisdictionExtensions' => [
        
    ],
    'originationFeeAmount' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "X-Idempotency: <x-idempotency>"
  ],
]);

$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-applications/{id}/disburse"

	payload := strings.NewReader("{\n  \"disbursedAt\": \"<string>\",\n  \"grossRequestedAmount\": \"<string>\",\n  \"loanAccountId\": \"<string>\",\n  \"netDeliveredAmount\": \"<string>\",\n  \"currency\": \"<string>\",\n  \"jurisdictionExtensions\": {},\n  \"originationFeeAmount\": \"<string>\"\n}")

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

	req.Header.Add("X-Idempotency", "<x-idempotency>")
	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-applications/{id}/disburse")
  .header("X-Idempotency", "<x-idempotency>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"disbursedAt\": \"<string>\",\n  \"grossRequestedAmount\": \"<string>\",\n  \"loanAccountId\": \"<string>\",\n  \"netDeliveredAmount\": \"<string>\",\n  \"currency\": \"<string>\",\n  \"jurisdictionExtensions\": {},\n  \"originationFeeAmount\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Post.new(url)
request["X-Idempotency"] = '<x-idempotency>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"disbursedAt\": \"<string>\",\n  \"grossRequestedAmount\": \"<string>\",\n  \"loanAccountId\": \"<string>\",\n  \"netDeliveredAmount\": \"<string>\",\n  \"currency\": \"<string>\",\n  \"jurisdictionExtensions\": {},\n  \"originationFeeAmount\": \"<string>\"\n}"

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

{
  "assignedOfficerId": "<string>",
  "borrowerId": "<string>",
  "expectedDisbursementDate": "<string>",
  "id": "<string>",
  "loanProductVersionId": "<string>",
  "previewJurisdictionCode": "<string>",
  "previewProfileVersion": "<string>",
  "previewScheduleSnapshotId": "<string>",
  "requestedInstallments": 123,
  "requestedInterestRate": "<string>",
  "requestedPrincipalAmount": "<string>",
  "status": "<string>",
  "approvalDecision": {
    "approvedAmount": "<string>",
    "decidedBy": "<string>",
    "decisionAt": "<string>",
    "id": "<string>",
    "note": "<string>"
  },
  "disbursementEvent": {
    "disbursedAt": "<string>",
    "grossRequestedAmount": "<string>",
    "id": "<string>",
    "loanAccountId": "<string>",
    "netDeliveredAmount": "<string>",
    "profileVersion": "<string>"
  },
  "rejectionDecision": {
    "decidedBy": "<string>",
    "decisionAt": "<string>",
    "id": "<string>",
    "reason": "<string>"
  },
  "withdrawalDecision": {
    "decidedBy": "<string>",
    "decisionAt": "<string>",
    "id": "<string>",
    "reason": "<string>"
  }
}

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

{id}

disburse

Disburse loan application

curl --request POST \
  --url https://lender.sandbox.lerian.net/api/v1/loan-applications/{id}/disburse \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Idempotency: <x-idempotency>' \
  --data '
{
  "disbursedAt": "<string>",
  "grossRequestedAmount": "<string>",
  "loanAccountId": "<string>",
  "netDeliveredAmount": "<string>",
  "currency": "<string>",
  "jurisdictionExtensions": {},
  "originationFeeAmount": "<string>"
}
'

import requests

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

payload = {
    "disbursedAt": "<string>",
    "grossRequestedAmount": "<string>",
    "loanAccountId": "<string>",
    "netDeliveredAmount": "<string>",
    "currency": "<string>",
    "jurisdictionExtensions": {},
    "originationFeeAmount": "<string>"
}
headers = {
    "X-Idempotency": "<x-idempotency>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'X-Idempotency': '<x-idempotency>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    disbursedAt: '<string>',
    grossRequestedAmount: '<string>',
    loanAccountId: '<string>',
    netDeliveredAmount: '<string>',
    currency: '<string>',
    jurisdictionExtensions: {},
    originationFeeAmount: '<string>'
  })
};

fetch('https://lender.sandbox.lerian.net/api/v1/loan-applications/{id}/disburse', 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-applications/{id}/disburse",
  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([
    'disbursedAt' => '<string>',
    'grossRequestedAmount' => '<string>',
    'loanAccountId' => '<string>',
    'netDeliveredAmount' => '<string>',
    'currency' => '<string>',
    'jurisdictionExtensions' => [
        
    ],
    'originationFeeAmount' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "X-Idempotency: <x-idempotency>"
  ],
]);

$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-applications/{id}/disburse"

	payload := strings.NewReader("{\n  \"disbursedAt\": \"<string>\",\n  \"grossRequestedAmount\": \"<string>\",\n  \"loanAccountId\": \"<string>\",\n  \"netDeliveredAmount\": \"<string>\",\n  \"currency\": \"<string>\",\n  \"jurisdictionExtensions\": {},\n  \"originationFeeAmount\": \"<string>\"\n}")

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

	req.Header.Add("X-Idempotency", "<x-idempotency>")
	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-applications/{id}/disburse")
  .header("X-Idempotency", "<x-idempotency>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"disbursedAt\": \"<string>\",\n  \"grossRequestedAmount\": \"<string>\",\n  \"loanAccountId\": \"<string>\",\n  \"netDeliveredAmount\": \"<string>\",\n  \"currency\": \"<string>\",\n  \"jurisdictionExtensions\": {},\n  \"originationFeeAmount\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Post.new(url)
request["X-Idempotency"] = '<x-idempotency>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"disbursedAt\": \"<string>\",\n  \"grossRequestedAmount\": \"<string>\",\n  \"loanAccountId\": \"<string>\",\n  \"netDeliveredAmount\": \"<string>\",\n  \"currency\": \"<string>\",\n  \"jurisdictionExtensions\": {},\n  \"originationFeeAmount\": \"<string>\"\n}"

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

{
  "assignedOfficerId": "<string>",
  "borrowerId": "<string>",
  "expectedDisbursementDate": "<string>",
  "id": "<string>",
  "loanProductVersionId": "<string>",
  "previewJurisdictionCode": "<string>",
  "previewProfileVersion": "<string>",
  "previewScheduleSnapshotId": "<string>",
  "requestedInstallments": 123,
  "requestedInterestRate": "<string>",
  "requestedPrincipalAmount": "<string>",
  "status": "<string>",
  "approvalDecision": {
    "approvedAmount": "<string>",
    "decidedBy": "<string>",
    "decisionAt": "<string>",
    "id": "<string>",
    "note": "<string>"
  },
  "disbursementEvent": {
    "disbursedAt": "<string>",
    "grossRequestedAmount": "<string>",
    "id": "<string>",
    "loanAccountId": "<string>",
    "netDeliveredAmount": "<string>",
    "profileVersion": "<string>"
  },
  "rejectionDecision": {
    "decidedBy": "<string>",
    "decisionAt": "<string>",
    "id": "<string>",
    "reason": "<string>"
  },
  "withdrawalDecision": {
    "decidedBy": "<string>",
    "decisionAt": "<string>",
    "id": "<string>",
    "reason": "<string>"
  }
}

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

Headers

X-Idempotency

string

required

Canonical idempotency request ID (lib-commons enforcer reads this).

Path Parameters

string<uuid>

required

Loan application identifier.

Example:

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

Body

application/json

disbursedAt

string

required

Disbursement timestamp (RFC3339).

Example:

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

grossRequestedAmount

string

required

Gross requested disbursement amount as a decimal string (e.g. "50000.00").

Example:

"50000.00"

loanAccountId

string

required

Loan account identifier (UUID).

Example:

"7c9e6679-7425-40de-944b-e07fc1f90ae7"

netDeliveredAmount

string

required

Net delivered disbursement amount as a decimal string (e.g. "49500.00").

Example:

"49500.00"

currency

string

Optional ISO-4217 currency assertion (3 uppercase letters). When present it MUST equal the loan application's currency (a double-entry guard); a divergence is rejected with 422. When omitted, the loan's own currency is used.

Required string length: 3

Pattern: ^[A-Z]{3}$

Example:

"BRL"

jurisdictionExtensions

object

Opaque per-jurisdiction disbursement payload, validated at the use-case layer.

originationFeeAmount

string

Optional per-disbursement IF origination fee as a decimal string, net-of-IOF (e.g. "250.00"). Cost metadata persisted for accrual (AC0 = principal - fee); NOT a withholding and does not affect the Net = Gross - withholdings balance. Omitted or empty defaults to "0".

Example:

"250.00"

Response

assignedOfficerId

string

required

Authenticated officer who created the application (request subject).

borrowerId

string

required

Borrower identifier.

expectedDisbursementDate

string

required

Expected disbursement date (RFC3339, UTC).

Example:

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

string

required

Loan application identifier (UUID).

Example:

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

loanProductVersionId

string

required

Loan product version this application was created against (UUID).

Example:

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

previewJurisdictionCode

string

required

ISO-2 jurisdiction code resolved at preview time.

Example:

"BR"

previewProfileVersion

string

required

Jurisdiction profile version resolved at preview time.

Example:

"1.0.0"

previewScheduleSnapshotId

string

required

Preview schedule snapshot this application was created from (UUID).

Example:

"6ba7b810-9dad-11d1-80b4-00c04fd430c8"

requestedInstallments

integer<int64>

required

Number of installments requested.

Example:

24

requestedInterestRate

string

required

Requested monthly interest rate as a decimal string, scale 8 (e.g. "0.00000100").

Example:

"0.00000100"

requestedPrincipalAmount

string

required

Requested principal amount as a decimal string, minor-unit precision scale 2 (e.g. "50000.00").

Example:

"50000.00"

status

string

required

Lifecycle status: one of pending_approval, approved, rejected, withdrawn, disbursed.

Example:

"pending_approval"

approvalDecision

object

Approval facts; present only when the application is approved or disbursed.

Show child attributes

disbursementEvent

object

Disbursement facts; present only when the application is disbursed.

Show child attributes

rejectionDecision

object

Rejection facts; present only when the application is rejected.

Show child attributes

withdrawalDecision

object

Withdrawal facts; present only when the application is withdrawn.

Show child attributes

⌘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

Disburse loan application

Authorizations

Headers

Path Parameters

Body

Response