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

# Create Loan Request

> Ask the lender of record to approve a new loan or an additional draw

Creates a loan request on a market that runs [approve-only loans](https://docs.trusset.org/endpoints/lending/loan-approvals.md). Leave `loanId` out to ask for a new loan. Name an open loan of the borrower in `loanId` to ask for an additional draw.

Limits and replacement are per instance:

* A new request for the same wallet and loan replaces your instance's own waiting request. The answer names the replaced request in `replaced`.
* Your instance keeps at most 3 waiting requests per wallet and 25 per market. Beyond that the route answers `429 LOAN_REQUEST_LIMIT`. Only `REQUESTED` requests count, and the one being replaced does not.
* Requests by different instances for the same wallet do not block each other.

The routes carry no personal data fields. Send wallet addresses, amounts and `externalReference` only.

## Path Parameters

**marketId** `string` *required*

The market's record ID on your instance.

## Body Parameters

**borrowerWallet** `string` *required*

The wallet that will borrow.

**borrowAmount** `string | number` *required*

The amount to borrow.

**collateralAmount** `string | number`

The collateral amount.

**loanId** `string | number | null`

Leave out for a new loan. Name an open loan of that borrower to request an additional draw.

**externalReference** `string | null`

Your own case or file number: 1 to 64 letters, digits, dots, underscores or hyphens. No personal data.

## Response Fields

Answers `201`.

**data** `object`

**request** `object`

The loan request. See [Get Loan Request](https://docs.trusset.org/endpoints/lending/get-loan-request.md#response-fields) for every field.

**created** `boolean`

`true`.

**replaced** `string | null`

The reference of your instance's earlier waiting request this one replaced, or `null`.

**marketId** `string`

The market's record ID on your instance.

```json 201 Requested theme={null}
{
  "success": true,
  "data": {
    "request": {
      "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": true,
      "viewerRole": {
        "bank": false,
        "borrower": true
      },
      "nextStep": "WAIT_FOR_BANK"
    },
    "created": true,
    "replaced": null,
    "marketId": "cmwfk2h7x0003jw9w4q8b2n1c"
  },
  "error": null
}
```

## Error Codes

| Code | HTTP | Cause |
| - | - | - |
| `INVALID_WALLET` | `400` | `borrowerWallet` is not an address |
| `INVALID_LOAN_ID` | `400` | `loanId` is not a loan ID |
| `INVALID_AMOUNT` | `400` | An amount is not valid |
| `INVALID_EXTERNAL_REFERENCE` | `400` | `externalReference` is not 1 to 64 letters, digits, dots, underscores or hyphens |
| `PERSONAL_DATA_REFUSED` | `400` | The body carries a personal data field. The routes carry none |
| `LOAN_NOT_FOUND` | `404` | `loanId` names no open loan of that borrower |
| `LOAN_APPROVAL_NOT_REQUIRED` | `409` | The market does not require approvals. Open the loan directly |
| `LOAN_APPROVALS_CUSTOM` | `409` | The market names an approvals contract that the Trusset approvals factory did not build, which the API cannot read or write |
| `LOAN_REQUEST_OPEN` | `409` | Your instance made the same request a moment ago, and that request stands. This is a concurrent duplicate. Read the loan requests to find it |
| `LOAN_REQUEST_LIMIT` | `429` | Your instance already keeps 3 waiting requests for this wallet, or 25 waiting requests on this market. Withdraw one or wait for the lender of record to decide |


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