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

> Every token your instance has imported

Returns every active import held by the instance bound to your API key, newest first. Revoked imports are excluded.

<Warning>
  `data` is the array itself, not an object wrapping one. There is no `data.imports`. It is also unpaginated: an instance holds at most 200 active imports and all of them are returned.
</Warning>

## Response Fields

<ResponseField name="data" type="array">
  <Expandable>
    <ResponseField name="tokenAddress" type="string">The imported address, lowercased. Every other endpoint on this surface takes it.</ResponseField>
    <ResponseField name="name" type="string">Name read from the contract at import or last refresh.</ResponseField>
    <ResponseField name="symbol" type="string">Symbol read from the contract.</ResponseField>
    <ResponseField name="decimals" type="integer">Decimals read from the contract. Always `0` for `erc721` and `erc1155`.</ResponseField>
    <ResponseField name="framework" type="string">`erc3643`, `erc1400`, `erc721`, `erc1155` or `erc20`.</ResponseField>
    <ResponseField name="assetType" type="string">The classification the importer chose. Issuer-asserted.</ResponseField>
    <ResponseField name="imageURI" type="string">Icon URI, or `null`.</ResponseField>
    <ResponseField name="totalSupply" type="string">Supply as of the last chain read, not as of this request.</ResponseField>
    <ResponseField name="metadata" type="object">The framework-specific facts detection found, the same shape as `details` on [Detect Token](/endpoints/tokenization/detect-token).</ResponseField>
    <ResponseField name="importedAt" type="string">ISO 8601 timestamp.</ResponseField>
    <ResponseField name="instanceId" type="string">The instance holding the record, which is always the one bound to your key.</ResponseField>
  </Expandable>
</ResponseField>

<Note>
  `profile` is not on this list. It is only on [Get Import](/endpoints/tokenization/get-import), because a directory rarely needs the full published description of every asset at once.
</Note>

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

  ```typescript TypeScript theme={null}
  const res = await fetch(
    'https://api.trusset.org/external-tokens/api/list',
    { headers: { 'X-API-Key': 'trusset_your_key_here' } }
  );
  const { data } = await res.json();

  const collateralCandidates = data.filter(
    (t: any) => t.framework === 'erc3643' || t.framework === 'erc1400'
  );
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "success": true,
    "data": [
      {
        "tokenAddress": "0x9f8c1d4b2e7a3056c1b8f4d29e0a7c3518b6d24f",
        "name": "Nyala Fund I",
        "symbol": "NYF1",
        "decimals": 18,
        "framework": "erc3643",
        "assetType": "BOND",
        "imageURI": "ipfs://bafkreigh2akiscaildc7fh4dqwv6zqm4",
        "totalSupply": "5000000.0",
        "metadata": {
          "identityRegistry": "0x9e3c8A15f4d70b2681C5a3f9027d4bE8115C7d21",
          "compliance": "0x2b7Ff4E80a1c53D6970bC81dE4a5f0917Ac3d829",
          "onchainID": null,
          "paused": false
        },
        "importedAt": "2026-09-05T12:00:00.000Z",
        "instanceId": "inst_abc123"
      }
    ]
  }
  ```
</ResponseExample>

## Error Codes

| Code           | HTTP  | Cause                                                                                       |
| -------------- | ----- | ------------------------------------------------------------------------------------------- |
| `FETCH_FAILED` | `500` | The import list could not be read. An empty array is never served in place of a failed read |