---
title: "Get token by id"
method: GET
path: "/api/v1/tokens/{tokenId}"
tags: ["tokens"]
---

# Get token by id

`GET /api/v1/tokens/{tokenId}`

Returns token entity information given the id

## Path parameters

- `tokenId` string, nullable, required — Network entity ID in the format of `shard.realm.num`

## Query parameters

- `timestamp` string

## Response `200`

OK

- TokenInfo
  - `admin_key` Key, nullable — The public key which controls access to various network entities.
    - `_type` 'ECDSA_SECP256K1' | 'ED25519' | 'ProtobufEncoded'
    - `key` string
  - `auto_renew_account` string, nullable — Network entity ID in the format of `shard.realm.num`
  - `auto_renew_period` integer, nullable
  - `created_timestamp` string — A Unix timestamp in seconds.nanoseconds format
  - `decimals` string
  - `deleted` boolean, nullable
  - `expiry_timestamp` integer, nullable
  - `fee_schedule_key` Key, nullable — The public key which controls access to various network entities.
    - `_type` 'ECDSA_SECP256K1' | 'ED25519' | 'ProtobufEncoded'
    - `key` string
  - `freeze_default` boolean
  - `freeze_key` Key, nullable — The public key which controls access to various network entities.
    - `_type` 'ECDSA_SECP256K1' | 'ED25519' | 'ProtobufEncoded'
    - `key` string
  - `initial_supply` string
  - `kyc_key` Key, nullable — The public key which controls access to various network entities.
    - `_type` 'ECDSA_SECP256K1' | 'ED25519' | 'ProtobufEncoded'
    - `key` string
  - `max_supply` string
  - `metadata` string, byte — Arbitrary binary data associated with this token class encoded in base64.
  - `metadata_key` object, nullable — The key which can change the metadata of a token and individual NFTs.
    - `_type` 'ECDSA_SECP256K1' | 'ED25519' | 'ProtobufEncoded'
    - `key` string
  - `modified_timestamp` string — A Unix timestamp in seconds.nanoseconds format
  - `name` string
  - `memo` string
  - `pause_key` Key, nullable — The public key which controls access to various network entities.
    - `_type` 'ECDSA_SECP256K1' | 'ED25519' | 'ProtobufEncoded'
    - `key` string
  - `pause_status` 'NOT_APPLICABLE' | 'PAUSED' | 'UNPAUSED'
  - `supply_key` Key, nullable — The public key which controls access to various network entities.
    - `_type` 'ECDSA_SECP256K1' | 'ED25519' | 'ProtobufEncoded'
    - `key` string
  - `supply_type` 'FINITE' | 'INFINITE'
  - `symbol` string
  - `token_id` string, nullable — Network entity ID in the format of `shard.realm.num`
  - `total_supply` string
  - `treasury_account_id` string, nullable — Network entity ID in the format of `shard.realm.num`
  - `type` 'FUNGIBLE_COMMON' | 'NON_FUNGIBLE_UNIQUE'
  - `wipe_key` Key, nullable — The public key which controls access to various network entities.
    - `_type` 'ECDSA_SECP256K1' | 'ED25519' | 'ProtobufEncoded'
    - `key` string
  - `custom_fees` CustomFees
    - `created_timestamp` string — A Unix timestamp in seconds.nanoseconds format
    - `fixed_fees` FixedFee[]
      - `all_collectors_are_exempt` boolean
      - `amount` integer
      - `collector_account_id` string, nullable — Network entity ID in the format of `shard.realm.num`
      - `denominating_token_id` string, nullable — Network entity ID in the format of `shard.realm.num`
    - `fractional_fees` FractionalFee[]
      - `all_collectors_are_exempt` boolean
      - `amount` object
        - `numerator` integer
        - `denominator` integer
      - `collector_account_id` string, nullable — Network entity ID in the format of `shard.realm.num`
      - `denominating_token_id` string, nullable — Network entity ID in the format of `shard.realm.num`
      - `maximum` integer, nullable
      - `minimum` integer
      - `net_of_transfers` boolean
    - `royalty_fees` RoyaltyFee[]
      - `all_collectors_are_exempt` boolean
      - `amount` object
        - `numerator` integer
        - `denominator` integer
      - `collector_account_id` string, nullable — Network entity ID in the format of `shard.realm.num`
      - `fallback_fee` object
        - `amount` integer
        - `denominating_token_id` string, nullable — Network entity ID in the format of `shard.realm.num`

## Other responses

- `400` — Invalid parameter
- `404` — Not Found

## Changes

- **2025-10-16** (v1) `53ec95c5c91d` — 1 warning
  - changed the pattern of the `query` request parameter `timestamp` from `^((eq|lt|lte):)?\d{1,10}(.\d{1,9})?$` to `^((eq|lt|lte):)?\d{1,10}(\.\d{1,9})?$`
- **2025-08-08** (v1) `db389f03b097` — 25 breaking, 1 warning
  - the response property `_status/messages/items/data` became nullable for the status `400`
  - the response property `_status/messages/items/data` became nullable for the status `404`
  - the response property `_status/messages/items/detail` became nullable for the status `400`
  - the response property `_status/messages/items/detail` became nullable for the status `404`
  - …22 more

[Change history](https://skmtc.dev/hiero-ledger/apis/mirror-node-rest-api/changes/api/v1/tokens/:tokenId/get.md)

---

[API](https://skmtc.dev/hiero-ledger/apis/mirror-node-rest-api.md) · [All operations](https://skmtc.dev/hiero-ledger/apis/mirror-node-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hiero-ledger/mirror-node-rest-api/revisions/5db3d769fe21/schema)