Skip to main content
POST
/
v1
/
loans
/
{loan_id}
/
disburse
Disburse a loan
curl --request POST \
  --url https://api-dev.bsa.ai/v1/loans/{loan_id}/disburse \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "actualDisbursementDate": "<string>",
  "transactionAmount": 123,
  "paymentTypeId": 123,
  "note": "<string>"
}
'

Documentation Index

Fetch the complete documentation index at: https://docs.api.bsa.ai/llms.txt

Use this file to discover all available pages before exploring further.

Disburses an approved loan. After successful disbursement, the loan transitions to active state and the repayment schedule becomes applicable.

​
Path parameters

​
loan_id
string
required

​
Request body

​
actualDisbursementDate
string
required
ISO-8601 YYYY-MM-DD.
​
transactionAmount
number
Optional. Amount to disburse — defaults to the approved principal. Provide a smaller value for partial disbursements (where the product permits).
​
paymentTypeId
integer
Optional. Reference to an LMS payment-type code (cash, bank transfer, mobile money, etc.).
​
note
string
Optional free-text disbursement note.

​
Example

curl -sf -X POST "$BASE/v1/loans/501/disburse" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "actualDisbursementDate": "2026-06-01",
    "paymentTypeId": 3
  }'

​
Response

200 OK returns the loan object with status="Active".

​
Errors

CodeWhen
not_foundNo loan with that ID
abortedLoan is not in approved state
invalid_argumentMissing actualDisbursementDate, or amount exceeds approved principal