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

# List Loan Requests

> List the loan requests of a market

Lists the market's loan requests. The lender of record sees every request of the market. Any other instance sees the requests it made and those naming one of its verified wallets.

The list is paged with `limit` and `offset`. Without a `status` filter, open requests come first: `REQUESTED`, then `APPROVED`, then the rest, each with the newest change first. A waiting request is never cut off by newer history. With a `status` filter, the newest change comes first.

## Path Parameters

**marketId** `string` *required*

The market's record ID on your instance.

## Query Parameters

**status** `string`

One status: `REQUESTED`, `APPROVED`, `USED`, `DECLINED`, `WITHDRAWN`, `REVOKED`, `EXPIRED` or `CLOSED`. Any other value answers `400 INVALID_STATUS`.

**borrower** `string`

Only this wallet's requests.

**limit** `number` (default: 200)

How many requests to return, from 1 to 200.

**offset** `number` (default: 0)

How many matching requests to skip.

## Response Fields

**data** `object`

**requests** `object[]`

Each as [Get Loan Request](https://docs.trusset.org/endpoints/lending/get-loan-request.md#response-fields) returns it.

**total** `number`

How many requests match, across all pages.

**limit** `number`

The page size that was applied.

**offset** `number`

The offset that was applied.

**truncated** `boolean`

`true` when more requests match beyond this page. Read the next page with `offset`.

**waiting** `number`

How many requests your instance sees that are still `REQUESTED`, whatever the page and the `status` filter. A `borrower` filter narrows it.

**mode** `object`

The market's mode. See [Get Loan Approvals](https://docs.trusset.org/endpoints/lending/get-loan-approvals.md#response-fields).

**viewer.isBank** `boolean`

Whether your instance sees every request as the lender of record.

**marketId** `string`

The market's record ID on your instance.

```json 200 Listed theme={null}
{
  "success": true,
  "data": {
    "requests": [
      {
        "ref": "lrq_k3vx7q2mwd4h5pn6tr2a",
        "kind": "OPEN",
        "loanId": null,
        "status": "REQUESTED",
        "marketAddress": "0x41b9c4d5dee70a5e3682094462e5065275e728a9",
        "borrowerWallet": "0x7c1e3a5f2b9d4e6a8c0f1b3d5e7a9c2b4d6f8e1a",
        "externalReference": "CASE-2026.11_042",
        "amount": "25000",
        "amountRaw": "25000000000",
        "collateralAmount": "40",
        "symbol": "USDC",
        "decimals": 6,
        "approvedAmount": null,
        "approvedAmountRaw": null,
        "validUntil": null,
        "approver": null,
        "approveTxHash": null,
        "decidedAt": null,
        "usedTxHash": null,
        "usedAt": null,
        "createdAt": "2026-11-21T16:02:11.000Z",
        "updatedAt": "2026-11-21T16:02:11.000Z",
        "requestedByThisInstance": false,
        "viewerRole": {
          "bank": true,
          "borrower": false
        },
        "nextStep": "APPROVE_OR_DECLINE"
      }
    ],
    "total": 1,
    "limit": 200,
    "offset": 0,
    "truncated": false,
    "waiting": 1,
    "mode": {
      "supported": true,
      "available": true,
      "enabled": true,
      "requested": false,
      "approvals": "0x5d2e8c1a7f4b3960e2d1c8a7b6f5e4d3c2b1a098",
      "canonical": true,
      "upgradeRequired": false,
      "approverRole": "0x46f54e51673dd785402ec1df75a85f2b1da1abc02695cc95d95578f830f58153",
      "maxValidHours": 696,
      "viewer": {
        "isBank": true,
        "isAdmin": true,
        "approverWallets": [
          "0x7712db30a7b4ffd9c445793089118b60e56d752a"
        ]
      }
    },
    "viewer": {
      "isBank": true
    },
    "marketId": "cmwfk2h7x0003jw9w4q8b2n1c"
  },
  "error": null
}
```

## Error Codes

| Code | HTTP | Cause |
| - | - | - |
| `INVALID_STATUS` | `400` | `status` is not one of the eight statuses |
| `INVALID_WALLET` | `400` | `borrower` is not an address |
| `VALIDATION_ERROR` | `400` | `limit` is not a whole number from 1 to 200, or `offset` is not a whole number from 0 to 1000000 |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.