Skip to main content
POST
/
v1
/
loans
/
{loan_id}
/
approve
Approve a loan
curl --request POST \
  --url https://api-dev.bsa.ai/v1/loans/{loan_id}/approve \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "approvedOnDate": "<string>",
  "approvedLoanAmount": 123,
  "expectedDisbursementDate": "<string>",
  "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.

Approves a submitted loan. The approver can optionally adjust the approved principal downward and revise the expected disbursement date.

​
Path parameters

​
loan_id
string
required

​
Request body

​
approvedOnDate
string
required
ISO-8601 YYYY-MM-DD. Must be on or after submittedOnDate.
​
approvedLoanAmount
number
Optional. Approved principal — may be lower than the requested principal. Defaults to the originally-requested amount.
​
expectedDisbursementDate
string
Optional. ISO-8601 YYYY-MM-DD. Use to push the planned disbursement.
​
note
string
Free-text approver note. Recorded on the loan.

​
Example

curl -sf -X POST "$BASE/v1/loans/501/approve" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "approvedOnDate": "2026-05-23",
    "approvedLoanAmount": 4500,
    "note": "Reduced based on collateral assessment"
  }'

​
Response

200 OK returns the loan object with status="Approved" and approvedPrincipal populated.

​
Errors

CodeWhen
not_foundNo loan with that ID
abortedLoan is not in submitted state
invalid_argumentMissing approvedOnDate, or approved amount violates product limits