MCA Suite v2 Docs

Loan Balances

Get loan balances

GET /v1/loan/balances

Retrieves all active deals with funded loans where loan balance and principal balance are greater than 0. Returns up to 1000 records per call.

Query parameters

FieldTypeDescription
dealIdsstring[]Filter to specific deal public IDs.
statusesstring[]Filter by deal status.
nextIdstringPublic ID of the last deal from the previous response, for pagination.
limitnumberMax 1000, defaults to 1000.

Example

balances = client.loans.get_balances(limit=100)
for loan in balances.data:
    print(loan.dealId, loan.loanBalance)
 
if balances.nextId:
    next_page = client.loans.get_balances(limit=100, next_id=balances.nextId)

Example response

{
  "success": true,
  "count": 1,
  "data": [
    {
      "dealId": "abc123xyz",
      "dealName": "ABC Corp Loan",
      "companyName": "ABC Corporation",
      "status": "Funded",
      "totalRepaid": 5000,
      "loanBalance": 15000,
      "principalBalance": 12000
    }
  ],
  "nextId": null
}