---
title: "List tokens"
method: GET
path: "/v1/issuance/tokens"
tags: ["Issuance"]
---

# List tokens

`GET /v1/issuance/tokens`

Lists tokens for the current project or organization. Supports contains-style search, filtering and sorting; `meta.total` always reflects the active filters. Ordering carries an id tiebreaker, so paging is stable across tokens that share a timestamp or name.

## Query parameters

- `page` integer — Page number (1-based).
- `pageSize` integer — Items per page (max 100).
- `search` string — Contains-style, case-insensitive match over name, symbol, mint address and token id. LIKE wildcards are matched literally. A blank value is treated as no search filter.
- `status` 'pending' | 'active' | 'paused' | 'revoked' — Filter by the stored lifecycle column.
- `deploymentStatus` 'draft' | 'active' | 'paused' — Filter by derived lifecycle state: draft until the token has a mint, paused when the mint is paused, active otherwise.
- `template` string — Exact-match template id. Use GET /v1/issuance/tokens/facets for the ids present in the project (older tokens may hold legacy ids).
- `createdAfter` string, date-time — Inclusive lower bound on creation time (ISO 8601).
- `createdBefore` string, date-time — Inclusive upper bound on creation time (ISO 8601).
- `sortBy` 'createdAt' | 'name' — Field used to sort the token list.
- `sortDirection` 'asc' | 'desc' — Sort direction.

## Headers

- `x-project-id` string — Selects the active project for this request. Required for session/dashboard callers. Ignored when authenticating with an API key, whose scope is fixed to the key's project.

## Response `200`

Token list

- object — Standard paginated response envelope.
  - `data` object[], required
    - `id` string, required — Token identifier.
    - `projectId` string, required — Project identifier.
    - `organizationId` string, required — Organization identifier.
    - `signingWalletId` string, nullable, required — Preferred signer wallet for token deploy/admin/write actions.
    - `mintAddress` string, nullable, required — Mint address once deployed.
    - `mintAuthority` string, nullable, required — Mint authority address, if set.
    - `freezeAuthority` string, nullable, required — Freeze authority address, if set.
    - `ablListAddress` string, nullable, required — On-chain allowlist/blocklist address, if enabled.
    - `name` string, required — Token name.
    - `symbol` string, required — Token symbol.
    - `decimals` integer, required — Token decimals.
    - `description` string, nullable, required — Token description.
    - `uri` string, nullable, required — Metadata URI passed to on-chain token metadata (points to off-chain JSON).
    - `imageUrl` string, nullable, required — Token image URL.
    - `template` 'stablecoin' | 'arcade' | 'tokenized-security' | 'custom' | 'rwa', required — Token template identifier.
    - `extensions` object, nullable, required — Token-2022 extensions configuration.
      - `transferFee` object — Transfer fee configuration.
        - `basisPoints` integer, required — Transfer fee in basis points (0-10000).
        - `maxFee` string, required — Maximum fee in UI units.
        - `transferFeeConfigAuthority` string, required — Authority to configure transfer fees.
        - `withdrawWithheldAuthority` string, required — Authority to withdraw withheld fees.
      - `interestBearing` object — Interest-bearing configuration.
        - `rate` number, required — Interest rate in percent.
        - `rateAuthority` string, required — Authority that can update the rate.
      - `permanentDelegate` string — Permanent delegate address.
      - `pausable` object — Pausable configuration.
        - `authority` string — Authority that can pause/resume transfers.
      - `nonTransferable` boolean — Mark token as non-transferable.
      - `defaultAccountState` 'initialized' | 'frozen' — Default account state.
      - `scaledUiAmount` object — Scaled UI amount configuration.
        - `authority` string — Authority that can update scaled UI parameters.
        - `multiplier` number, required — Current UI multiplier.
        - `newMultiplier` number, required — Scheduled multiplier.
        - `newMultiplierEffectiveTimestamp` integer, required — Unix timestamp (seconds) when the new multiplier takes effect.
      - `transferHook` object — Transfer hook configuration.
        - `programId` string, required — Transfer hook program id.
        - `authority` string — Authority that can update the transfer hook program.
    - `totalSupply` string, required — Cached total supply in UI units (stored to avoid frequent RPC reads). Use POST /v1/issuance/tokens/{tokenId}/supply/refresh to force an on-chain refresh.
    - `totalSupplyUpdatedAt` string, date-time, nullable, required — Timestamp when supply was last refreshed.
    - `maxSupply` string, nullable, required — Maximum supply in UI units, if capped.
    - `isMintable` boolean, required — Whether additional minting is allowed.
    - `isFreezable` boolean, required — Whether freeze authority is enabled.
    - `requiresAllowlist` boolean, required — Whether transfers require allowlist approval.
    - `status` 'pending' | 'active' | 'paused' | 'revoked', required — Token lifecycle status.
    - `deployedAt` string, date-time, nullable, required — Deployment timestamp, if deployed.
    - `createdBy` string, required — Actor identifier that created the token.
    - `createdAt` string, date-time, required — Creation timestamp.
    - `updatedAt` string, date-time, required — Last update timestamp.
  - `meta` object, required — Pagination metadata.
    - `total` integer, required — Total items.
    - `page` integer, required — Current page number.
    - `pageSize` integer, required — Items per page.
    - `hasMore` boolean, required — Whether more pages exist.
    - `requestId` string, required — Request identifier for tracing.

## Other responses

- `400` — Error
- `401` — Error
- `403` — Error
- `500` — Error

---

[API](https://skmtc.net/solana/apis/solana-developer-platform-api.md) · [All operations](https://skmtc.net/solana/apis/solana-developer-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/solana/solana-developer-platform-api/revisions/672b1916ba61/schema)