List Loans

List loans, filtered by status or borrower, with cursor pagination.

GET /v1/finance/loans

cURL

curl 'https://api.stateset.com/v1/finance/loans' \
  -H 'Authorization: Bearer <token>'

200

{
  "data": [
    {
      "loan_id": "loan_5z8nPq3oW7",
      "status": "ACTIVE",
      "outstanding_balance": "23076.83",
      "ltv_ratio": 0.38,
      "liquidation_threshold": 0.75,
      "next_payment": { "due_date": "2024-08-25", "total": "2256.50" }
    }
  ]
}

Overview

Returns loans for the authenticated account. The view worth building first is the risk one — active positions ordered by loan-to-value, so whatever is closest to liquidation surfaces at the top. Filter client-side until the supported query parameters are confirmed.

The collateralized lending endpoints are not covered by a published OpenAPI specification. The request and response shapes below come from the Finance API guide; the filter parameters this endpoint accepts are not documented anywhere we can verify, so they are deliberately not listed rather than guessed at.

Confirm the supported filters with the implementation before building against them.

Response

data · array · required

The loans, each shaped as in Get Loan.

cURL

curl 'https://api.stateset.com/v1/finance/loans' \
  -H 'Authorization: Bearer <token>'

200

{
  "data": [
    {
      "loan_id": "loan_5z8nPq3oW7",
      "status": "ACTIVE",
      "outstanding_balance": "23076.83",
      "ltv_ratio": 0.38,
      "liquidation_threshold": 0.75,
      "next_payment": { "due_date": "2024-08-25", "total": "2256.50" }
    }
  ]
}

Related

• Get Loan
• Request Loan
• Finance — the lending product overview