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

# Get Loan Request

> Read one loan request

Returns one loan request with its status, the approval once it is given, and what your side does next.

## Path Parameters

**marketId** `string` *required*

The market's record ID on your instance.

**ref** `string` *required*

The loan request reference: `lrq_` followed by 20 characters.

## Response Fields

**data.request** `object`

**ref** `string`

`lrq_` followed by 20 characters.

**kind** `string`

`OPEN` for a new loan, `BORROW_MORE` for an additional draw on an open loan.

**loanId** `string | null`

The loan an additional draw belongs to. `null` for a new loan.

**status** `string`

`REQUESTED`, `APPROVED`, `USED`, `DECLINED`, `WITHDRAWN`, `REVOKED`, `EXPIRED` or `CLOSED`. See [States](https://docs.trusset.org/endpoints/lending/loan-approvals.md#states).

**marketAddress** `string`

The market contract.

**borrowerWallet** `string`

The borrowing wallet.

**externalReference** `string | null`

Your own case number, if given.

**amount** `string`

The requested amount, as a decimal string.

**amountRaw** `string`

The requested amount in base units.

**collateralAmount** `string | null`

The collateral amount named in the request, if any.

**symbol** `string`

Symbol of the borrow asset.

**decimals** `number`

Decimals of the borrow asset.

**approvedAmount** `string | null`

The approved amount, once approved.

**approvedAmountRaw** `string | null`

The approved amount in base units.

**validUntil** `string | null`

When the approval runs out, as an ISO 8601 timestamp.

**approver** `string | null`

The wallet that signed the approval.

**approveTxHash** `string | null`

The approval transaction.

**decidedAt** `string | null`

When the lender of record decided.

**usedTxHash** `string | null`

The transaction that consumed the approval.

**usedAt** `string | null`

When the approval was consumed.

**createdAt** `string`

ISO 8601 timestamp.

**updatedAt** `string`

ISO 8601 timestamp.

**requestedByThisInstance** `boolean`

Whether your instance made the request.

**viewerRole** `object`

`{ bank, borrower }` for your instance.

**nextStep** `string`

What your side does next: `APPROVE_OR_DECLINE`, `WAIT_FOR_BANK`, `OPEN_LOAN`, `WAIT_FOR_BORROWER` or `NONE`.

```json 200 Approved theme={null}
{
  "success": true,
  "data": {
    "request": {
      "ref": "lrq_k3vx7q2mwd4h5pn6tr2a",
      "kind": "OPEN",
      "loanId": null,
      "status": "APPROVED",
      "marketAddress": "0x41b9c4d5dee70a5e3682094462e5065275e728a9",
      "borrowerWallet": "0x7c1e3a5f2b9d4e6a8c0f1b3d5e7a9c2b4d6f8e1a",
      "externalReference": "CASE-2026.11_042",
      "amount": "25000",
      "amountRaw": "25000000000",
      "collateralAmount": "40",
      "symbol": "USDC",
      "decimals": 6,
      "approvedAmount": "25000",
      "approvedAmountRaw": "25000000000",
      "validUntil": "2026-11-24T16:40:00.000Z",
      "approver": "0x7712db30a7b4ffd9c445793089118b60e56d752a",
      "approveTxHash": "0x9f2c41d8b7e05a3164c2870fbd935e1a4c7802db6135ea9048f7c21b5d3ea41b",
      "decidedAt": "2026-11-21T16:41:07.000Z",
      "usedTxHash": null,
      "usedAt": null,
      "createdAt": "2026-11-21T16:02:11.000Z",
      "updatedAt": "2026-11-21T16:41:07.000Z",
      "requestedByThisInstance": true,
      "viewerRole": {
        "bank": false,
        "borrower": true
      },
      "nextStep": "OPEN_LOAN"
    },
    "marketId": "cmwfk2h7x0003jw9w4q8b2n1c"
  },
  "error": null
}
```


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