curl 'https://api.stateset.com/v1/finance/loans' \
-H 'Authorization: Bearer <token>'
{
"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" }
}
]
}
List Loans
List loans, filtered by status or borrower, with cursor pagination.
GET
/
v1
/
finance
/
loans
curl 'https://api.stateset.com/v1/finance/loans' \
-H 'Authorization: Bearer <token>'
{
"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
object[]
The loans, each shaped as in Get Loan.
Show loans
Show loans
string
required
Loan identifier.
string
required
PENDING_APPROVAL, APPROVED, ACTIVE, REPAID, or LIQUIDATED.string
required
Principal approved.
string
required
Principal actually drawn. Approved but undrawn principal accrues no interest.
string
required
Principal plus accrued interest still owed.
number
required
Annual rate as a decimal.
number
required
Loan term.
string
required
Current mark-to-market value of posted collateral.
number
required
Current loan-to-value — outstanding ÷ collateral value. Monitor this. It rises when collateral
falls in value as readily as when you draw more principal.
number
required
The LTV at which collateral is liquidated. The gap between this and
ltv_ratio is your headroom.object
required
Due date and amount of the next scheduled payment.
array
required
Every scheduled payment, each split into principal and interest.
Errors
Succeeds with200. Failures return 400, 401, 403 or 429 with an error body, per the platform status-code contract.
curl 'https://api.stateset.com/v1/finance/loans' \
-H 'Authorization: Bearer <token>'
{
"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
Last modified on August 29, 2026