Disbursements API¶

Manage loan funding through the disbursement lifecycle.

Base permission: IsViewerOrAbove (read), IsLoanOfficerOrAbove (write)

Endpoints¶

Method	Path	Description	Permission
`GET`	`/disbursements`	List all disbursements	`IsViewerOrAbove`
`GET`	`/disbursements/{id}`	Get disbursement	`IsViewerOrAbove`
`GET`	`/loans/{id}/disbursements`	List loan's disbursements	`IsViewerOrAbove`
`POST`	`/loans/{id}/disbursements`	Create disbursement	`IsLoanOfficerOrAbove`
`POST`	`/disbursements/{id}/process`	Process disbursement	`IsLoanOfficerOrAbove`
`POST`	`/disbursements/{id}/complete`	Complete disbursement	`IsLoanOfficerOrAbove`
`POST`	`/disbursements/{id}/fail`	Mark as failed	`IsLoanOfficerOrAbove`
`POST`	`/disbursements/{id}/cancel`	Cancel disbursement	`IsLoanOfficerOrAbove`

Create Disbursement¶

POST /api/v1/loans/{loan_id}/disbursements

{
  "amount": "10000.00",
  "disbursement_method": "ach",
  "recipient_type": "borrower",
  "recipient_name": "John Doe",
  "recipient_account_number_last_four": "6789",
  "scheduled_date": "2026-01-20"
}

Warning

The total of all disbursements on a loan cannot exceed the loan's principal amount. The API returns 409 Conflict if over-disbursement is attempted.

Disbursement Lifecycle¶

pending → processing → completed
                     → failed
         → cancelled

Process Disbursement¶

Initiates the funding transfer.

POST /api/v1/disbursements/{id}/process

Complete Disbursement¶

Marks funding as complete. This is the critical action that activates the loan.

POST /api/v1/disbursements/{id}/complete

{
  "completed_date": "2026-01-20"
}

Effects on completion:

Posts GL entries (DR Loans Receivable, CR Cash)
Generates the amortization schedule
Assesses origination fees (if configured on the product)
Transitions loan to active status (if all disbursements are complete)
Emits loan.disbursed webhook event

Recipient Types¶

Type	Description
`borrower`	Direct to borrower
`dealer`	To auto dealer or merchant
`merchant`	To merchant/vendor
`creditor`	Debt consolidation to creditor
`escrow`	To escrow account

Disbursement Methods¶

Method	Description
`ach`	ACH bank transfer
`wire`	Wire transfer
`check`	Physical check
`internal`	Internal transfer