> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stateset.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Loans

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

### 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.

<Warning>
  The collateralized lending endpoints are **not covered by a published OpenAPI specification**. The
  request and response shapes below come from the
  [Finance API guide](/stateset-commerce-api-reference/finance); 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.
</Warning>

### Response

<ResponseField name="data" type="array" required>
  The loans, each shaped as in [Get Loan](/stateset-commerce-api-reference/loans/get).
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl 'https://api.stateset.com/v1/finance/loans' \
    -H 'Authorization: Bearer <token>'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "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" }
      }
    ]
  }
  ```
</ResponseExample>

### Related

* [Get Loan](/stateset-commerce-api-reference/loans/get)
* [Request Loan](/stateset-commerce-api-reference/loans/request)
* [Finance](/stateset-commerce-api-reference/finance) — the lending product overview