latestOpenAPI 3.0.32026-08-20146131.7 MB

672b1916ba61

Issuance

List 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.

get/v1/issuance/tokens

Query parameters

pageinteger

Page number (1-based).

Example:1

Page number (1-based).

pageSizeinteger

Items per page (max 100).

Example:50

Items per page (max 100).

searchstring

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.

Example:usdc

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.

Example:active

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.

Example:active

Filter by derived lifecycle state: draft until the token has a mint, paused when the mint is paused, active otherwise.

templatestring

Exact-match template id. Use GET /v1/issuance/tokens/facets for the ids present in the project (older tokens may hold legacy ids).

Example:stablecoin

Exact-match template id. Use GET /v1/issuance/tokens/facets for the ids present in the project (older tokens may hold legacy ids).

createdAfterstring date-time

Inclusive lower bound on creation time (ISO 8601).

Example:2026-01-01T00:00:00.000Z

Inclusive lower bound on creation time (ISO 8601).

createdBeforestring date-time

Inclusive upper bound on creation time (ISO 8601).

Example:2026-06-30T23:59:59.999Z

Inclusive upper bound on creation time (ISO 8601).

sortBy'createdAt' | 'name'

Field used to sort the token list.

Example:createdAt

Field used to sort the token list.

sortDirection'asc' | 'desc'

Sort direction.

Example:desc

Sort direction.

Headers

x-project-idstring

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.

Example:prj_example

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

Token list

Example response

{
  "data": [
    {
      "id": "tok_example",
      "projectId": "prj_example",
      "organizationId": "org_example",
      "signingWalletId": "privy_wallet_123",
      "mintAddress": "So11111111111111111111111111111111111111112",
      "mintAuthority": "So11111111111111111111111111111111111111112",
      "freezeAuthority": "So11111111111111111111111111111111111111112",
      "ablListAddress": "So11111111111111111111111111111111111111112",
      "name": "Example Token",
      "symbol": "EXM",
      "decimals": 9,
      "description": "Example token description.",
      "uri": "https://example.com/metadata.json",
      "imageUrl": "https://example.com/token.png",
      "template": "stablecoin",
      "extensions": {
        "transferFee": {
          "basisPoints": 25,
          "maxFee": "0.5",
          "transferFeeConfigAuthority": "So11111111111111111111111111111111111111112",
          "withdrawWithheldAuthority": "So11111111111111111111111111111111111111112"
        },
        "interestBearing": {
          "rate": 2.5,
          "rateAuthority": "So11111111111111111111111111111111111111112"
        },
        "permanentDelegate": "So11111111111111111111111111111111111111112",
        "pausable": {
          "authority": "So11111111111111111111111111111111111111112"
        },
        "defaultAccountState": "initialized",
        "scaledUiAmount": {
          "authority": "So11111111111111111111111111111111111111112",
          "multiplier": 1,
          "newMultiplier": 2,
          "newMultiplierEffectiveTimestamp": 1735689600
        },
        "transferHook": {
          "programId": "So11111111111111111111111111111111111111112",
          "authority": "So11111111111111111111111111111111111111112"
        }
      },
      "totalSupply": "1000000",
      "maxSupply": "10000000",
      "isMintable": true,
      "isFreezable": true,
      "status": "active",
      "deployedAt": "2025-01-05T00:00:00.000Z",
      "createdBy": "key_example",
      "createdAt": "2025-01-01T00:00:00.000Z",
      "updatedAt": "2025-01-02T00:00:00.000Z"
    }
  ],
  "meta": {
    "requestId": "req_example"
  }
}