> ## 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 Extensions
> List the maturity extension proposals on a market and where each one stands
Lists every maturity extension proposal on the market, newest first. The list is read from the chain, where proposal IDs run from `1` without gaps, and merged with what Trusset recorded when each leg was confirmed. A proposal made outside Trusset still appears, with `recorded: false` and no transaction hashes.
Proposals are made with [Propose Extension](/endpoints/lending/propose-extension) and moved on with [Extension Action](/endpoints/lending/extension-action).
`chainReadFailed: true` means the chain did not answer and only recorded proposals are listed. Their state is then the last one Trusset saw, and a proposal made outside Trusset is missing. Retry before acting on it.
## Path Parameters
Market ID.
## Response Fields
Every proposal, ordered by `proposalId` from highest to lowest.
Proposal ID on the market. Use it with [Extension Action](/endpoints/lending/extension-action).
`LOAN` for one loan, `BATCH` for every loan open when it was proposed, `FLOOR` for a raise of the market due floor.
The loan a `LOAN` proposal extends. `null` for the other kinds.
The proposed maturity, in unix seconds.
For a `BATCH`, the loan counter when it was proposed: it reaches loans `1` to `maxLoanId` only. `null` for the other kinds.
Unix seconds after which an unconfirmed proposal can no longer be confirmed, seven days after it was made.
`true` for a `BATCH` the admin confirmed, which now waits for its loans to be applied in pages. A `LOAN` or `FLOOR` proposal applies on confirmation and moves straight to `consumed` instead.
`true` once a `LOAN` or `FLOOR` proposal was applied, or once any proposal was cancelled.
`true` when Trusset recorded a cancellation. `null` for a proposal Trusset has no record of, because the chain does not tell a cancellation from an application.
`true` for a proposal that was neither confirmed nor consumed before `validUntil`. A confirmed `BATCH` never expires.
Recorded transactions that extended at least one loan under this proposal. `null` when Trusset has no record of the proposal.
The wallet that sent the proposal. `null` when not recorded.
The proposing transaction. `null` when not recorded.
The confirming transaction. `null` when not recorded or not confirmed.
The cancelling transaction. `null` when not recorded or not cancelled.
Whether Trusset recorded the proposal through [Confirm Extension Transaction](/endpoints/lending/confirm-extension-transaction).
Whether your instance recorded it, rather than another instance that operates the same market. `null` when not recorded.
Whether the chain read returned this proposal. `false` means the state shown is Trusset's record.
`true` when the chain could not be read and only recorded proposals are listed.
```bash cURL theme={null}
curl "https://api.trusset.org/lending-external-securities-v2/api/markets/{marketId}/extensions" \
-H "X-API-Key: trusset_your_key_here"
```
```typescript TypeScript theme={null}
const res = await fetch(
`https://api.trusset.org/lending-external-securities-v2/api/markets/${marketId}/extensions`,
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
const awaitingPages = data.proposals.filter(p => p.kind === 'BATCH' && p.confirmed && !p.consumed);
```
```json Response theme={null}
{
"success": true,
"data": {
"proposals": [
{
"proposalId": "2",
"kind": "BATCH",
"loanId": null,
"newDueAt": "1797292800",
"maxLoanId": "14",
"validUntil": "1790121600",
"confirmed": true,
"consumed": false,
"cancelled": false,
"expired": false,
"appliedCount": 1,
"proposedBy": "0x5ad87a0621175206b72d10e4b8577b192e7f40ab",
"proposeTxHash": "0x61e2a05a0aedb4ad8aa58cae916a6a42589f454c439929c0510318b9ae54c6eb",
"confirmTxHash": "0xd06c7e62bde9120ec4a9af9161f7cab1a5d35abc7ce2ecf82b9634ec8566ed51",
"cancelTxHash": null,
"recorded": true,
"recordedByThisInstance": true,
"onChain": true
},
{
"proposalId": "1",
"kind": "LOAN",
"loanId": "5",
"newDueAt": "1795000000",
"maxLoanId": null,
"validUntil": "1789600000",
"confirmed": false,
"consumed": true,
"cancelled": null,
"expired": false,
"appliedCount": null,
"proposedBy": null,
"proposeTxHash": null,
"confirmTxHash": null,
"cancelTxHash": null,
"recorded": false,
"recordedByThisInstance": null,
"onChain": true
}
],
"chainReadFailed": false
}
}
```
## Error Codes
| Code | HTTP | Cause |
| ------------------- | ----- | --------------------------------------------------------- |
| `MISSING_MARKET_ID` | `400` | The `marketId` path segment is longer than 100 characters |
| `MARKET_NOT_FOUND` | `404` | No market with this ID on your instance |