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

> Read the candidates nominated to become a market lender of record

Returns the addresses nominated at deployment to take this market's lender-of-record role, together with whether the role has been taken and on what terms. See [Lender of record](/endpoints/external-securities-lending/introduction#lender-of-record).

Use it to tell an inert market apart from a live one before pointing borrowers or liquidity providers at it. While `seekingCurator` is `true`, opening a loan and providing liquidity are refused with `409 MARKET_PENDING_CURATOR`.

## Path Parameters

<ParamField path="marketId" type="string" required>Market ID.</ParamField>

## Response Fields

<ResponseField name="data" type="object">
  <Expandable>
    <ResponseField name="candidates" type="array">Nominated addresses, lowercased and deduplicated. Empty when the factory could not be read or the market predates the lender-of-record model.</ResponseField>
    <ResponseField name="curator" type="string">Address that holds the lender-of-record role, or null while the market is still seeking one.</ResponseField>
    <ResponseField name="seekingCurator" type="boolean">Whether the market is still seeking a lender of record.</ResponseField>
    <ResponseField name="realizationMode" type="string">How seized collateral is realized once the role is taken. `EXCHANGE_SALE`, `ISSUER_REDEMPTION`, `AUCTION`, or `UNDECLARED` before adoption. Null when the market records none.</ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.trusset.org/lending-external-securities/api/markets/{marketId}/nominations" \
    -H "X-API-Key: trusset_your_key_here"
  ```

  ```typescript TypeScript theme={null}
  const res = await fetch(
    `https://api.trusset.org/lending-external-securities/api/markets/${marketId}/nominations`,
    { headers: { 'X-API-Key': 'trusset_your_key_here' } }
  );
  const { data } = await res.json();
  if (data.seekingCurator) {
    showPendingBanner(data.candidates);
  }
  ```
</RequestExample>

<ResponseExample>
  ```json Response - Seeking theme={null}
  {
    "success": true,
    "data": {
      "candidates": [
        "0x4e91a7c05d3b62f18a0c94e7db2358f1c60a4e93",
        "0xb27d0f6a91c458e307b2d4f8916ac05e73128b64"
      ],
      "curator": null,
      "seekingCurator": true,
      "realizationMode": "UNDECLARED"
    }
  }
  ```

  ```json Response - Adopted theme={null}
  {
    "success": true,
    "data": {
      "candidates": [
        "0x4e91a7c05d3b62f18a0c94e7db2358f1c60a4e93",
        "0xb27d0f6a91c458e307b2d4f8916ac05e73128b64"
      ],
      "curator": "0x4e91a7c05d3b62f18a0c94e7db2358f1c60a4e93",
      "seekingCurator": false,
      "realizationMode": "EXCHANGE_SALE"
    }
  }
  ```
</ResponseExample>

## Error Codes

| Code                | HTTP  | Cause                                   |
| ------------------- | ----- | --------------------------------------- |
| `NO_MARKET_ADDRESS` | `400` | The market has no on-chain address      |
| `MARKET_NOT_FOUND`  | `404` | No market with this ID on your instance |