> ## Documentation Index
> Fetch the complete documentation index at: https://docs.quantumapi.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List token templates

> Pre-validated QRC contract templates that Qustody can instantiate during token deployment.

## `GET /v1/token-templates`

List the pre-validated token contract templates that Qustody can instantiate. Each template targets a single [QRC standard](/reference/token-standards) and exposes its constructor fields, supported operations, and feature flags (mintable, burnable, pausable, freezable, role-based).

| Aspect               | Detail                |
| -------------------- | --------------------- |
| Method               | `GET`                 |
| Path                 | `/v1/token-templates` |
| Authentication       | Bearer API key        |
| Required permissions | `tokens:read`         |
| Idempotent           | Yes — read-only       |
| Approval policy      | Not applicable        |
| Blockchain effect    | None                  |
| Webhook events       | None                  |

### Query parameters

| Name       | Type    | Description                             |
| ---------- | ------- | --------------------------------------- |
| `standard` | string  | Filter by QRC standard (e.g. `QRC-20`). |
| `limit`    | integer | Default `50`, max `200`.                |
| `offset`   | integer | Pagination offset.                      |

### Example response

```json theme={null}
{
  "data": [
    {
      "templateId": "tpl_qrc20_v1",
      "standard": "QRC-20",
      "name": "QRC-20 fungible token (default)",
      "version": "1.0.0",
      "constructorFields": [
        { "name": "name", "type": "string", "required": true },
        { "name": "symbol", "type": "string", "required": true },
        { "name": "decimals", "type": "uint8", "required": true, "default": 18 },
        { "name": "initialSupply", "type": "uint256", "required": false, "default": "0" }
      ],
      "supportedOperations": ["deploy", "mint", "burn", "transfer", "pause", "unpause"],
      "features": {
        "mintable": true,
        "burnable": true,
        "pausable": true,
        "freezable": false,
        "roleBased": true
      },
      "implementationStatus": "proposed"
    }
  ],
  "pagination": { "total": 1, "limit": 50, "offset": 0 }
}
```

## `GET /v1/token-templates/{templateId}`

Fetch a single template's full descriptor, including ABI and bytecode hash.

### Errors

| Code | Type                           | Meaning                                    |
| ---: | ------------------------------ | ------------------------------------------ |
| 1701 | `TOKEN_TEMPLATE_NOT_FOUND`     | Unknown template ID or standard mismatch.  |
| 1700 | `TOKEN_STANDARD_NOT_SUPPORTED` | Filter referenced an unsupported standard. |

## Related

* [Token standards reference](/reference/token-standards)
* [Create token](/api-reference/tokens/create-token)
* [Advanced contracts](/qustody/token-management/advanced-contracts) (when no template fits)