1 of 1

Get Token by ID

Get Token By ID.

This method will use 15 Compute Units.

Get Token by ID

Get Token By ID.

This method will use 15 Compute Units.

Get token by id

Returns token entity information given the id

GEThttps://mainnet.hedera.validationcloud.io/v1/YOUR_API_KEY/api/v1/tokens/{tokenId}

Path parameters

tokenId*nullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

Query parameters

timestampstring

Pattern: ^((eq|lt|lte):)?\d{1,10}(.\d{1,9})?$

Response

Body

admin_keynullable Key (object)

_typeenum

Example: "ProtobufEncoded"

ECDSA_SECP256K1ED25519ProtobufEncoded

keystring

Example: 10101

auto_renew_accountnullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

auto_renew_periodnullable integer (int64)

created_timestampTimestamp (string)

Example: "1586567700.453054000"

Pattern: ^\d{1,10}(\.\d{1,9})?$

decimalsstring

Example: 1000

deletednullable boolean

Example: true

expiry_timestampnullable integer (int64)

Example: 1234567890100000

fee_schedule_keynullable Key (object)

_typeenum

Example: "ProtobufEncoded"

ECDSA_SECP256K1ED25519ProtobufEncoded

keystring

Example: 10101

freeze_defaultboolean

Example: false

freeze_keynullable Key (object)

_typeenum

Example: "ProtobufEncoded"

ECDSA_SECP256K1ED25519ProtobufEncoded

keystring

Example: 10101

initial_supplystring

Example: "1000000"

kyc_keynullable Key (object)

_typeenum

Example: "ProtobufEncoded"

ECDSA_SECP256K1ED25519ProtobufEncoded

keystring

Example: 10101

max_supplystring

Example: "9223372036854775807"

modified_timestampTimestamp (string)

Example: "1586567700.453054000"

Pattern: ^\d{1,10}(\.\d{1,9})?$

namestring

Example: "Token name"

memostring

Example: "token memo"

pause_keynullable Key (object)

_typeenum

Example: "ProtobufEncoded"

ECDSA_SECP256K1ED25519ProtobufEncoded

keystring

Example: 10101

pause_statusenum

Example: "UNPAUSED"

NOT_APPLICABLEPAUSEDUNPAUSED

supply_keynullable Key (object)

_typeenum

Example: "ProtobufEncoded"

ECDSA_SECP256K1ED25519ProtobufEncoded

keystring

Example: 10101

supply_typeenum

Example: "INFINITE"

FINITEINFINITE

symbolstring

Example: "ORIGINALRDKSE"

token_idnullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

total_supplystring

Example: "1000000"

treasury_account_idnullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

typeenum

Example: "FUNGIBLE_COMMON"

FUNGIBLE_COMMONNON_FUNGIBLE_UNIQUE

wipe_keynullable Key (object)

_typeenum

Example: "ProtobufEncoded"

ECDSA_SECP256K1ED25519ProtobufEncoded

keystring

Example: 10101

custom_feesCustomFees (object)

created_timestampTimestamp (string)

Example: "1586567700.453054000"

Pattern: ^\d{1,10}(\.\d{1,9})?$

fixed_feesarray of FixedFee (object)

all_collectors_are_exemptboolean

Example: false

amountinteger (int64)

Example: 100

collector_account_idnullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

denominating_token_idnullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

fractional_feesarray of FractionalFee (object)

all_collectors_are_exemptboolean

Example: false

amountobject

numeratorinteger (int64)

Example: 12

denominatorinteger (int64)

Example: 29

collector_account_idnullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

denominating_token_idnullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

maximumnullable integer (int64)

Example: 120

minimuminteger (int64)

Example: 30

net_of_transfersboolean

Example: true

royalty_feesarray of RoyaltyFee (object)

all_collectors_are_exemptboolean

Example: false

amountobject

numeratorinteger (int64)

Example: 15

denominatorinteger (int64)

Example: 37

collector_account_idnullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

fallback_feeobject

amountinteger (int64)

Example: 100

denominating_token_idnullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

Request

Response

Get token by id

Returns token entity information given the id

GEThttps://mainnet.hedera.validationcloud.io/v1/YOUR_API_KEY/api/v1/tokens/{tokenId}

Path parameters

tokenId*nullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

Query parameters

timestampstring

Pattern: ^((eq|lt|lte):)?\d{1,10}(.\d{1,9})?$

Response

Body

admin_keynullable Key (object)

_typeenum

Example: "ProtobufEncoded"

ECDSA_SECP256K1ED25519ProtobufEncoded

keystring

Example: 10101

auto_renew_accountnullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

auto_renew_periodnullable integer (int64)

created_timestampTimestamp (string)

Example: "1586567700.453054000"

Pattern: ^\d{1,10}(\.\d{1,9})?$

decimalsstring

Example: 1000

deletednullable boolean

Example: true

expiry_timestampnullable integer (int64)

Example: 1234567890100000

fee_schedule_keynullable Key (object)

_typeenum

Example: "ProtobufEncoded"

ECDSA_SECP256K1ED25519ProtobufEncoded

keystring

Example: 10101

freeze_defaultboolean

Example: false

freeze_keynullable Key (object)

_typeenum

Example: "ProtobufEncoded"

ECDSA_SECP256K1ED25519ProtobufEncoded

keystring

Example: 10101

initial_supplystring

Example: "1000000"

kyc_keynullable Key (object)

_typeenum

Example: "ProtobufEncoded"

ECDSA_SECP256K1ED25519ProtobufEncoded

keystring

Example: 10101

max_supplystring

Example: "9223372036854775807"

modified_timestampTimestamp (string)

Example: "1586567700.453054000"

Pattern: ^\d{1,10}(\.\d{1,9})?$

namestring

Example: "Token name"

memostring

Example: "token memo"

pause_keynullable Key (object)

_typeenum

Example: "ProtobufEncoded"

ECDSA_SECP256K1ED25519ProtobufEncoded

keystring

Example: 10101

pause_statusenum

Example: "UNPAUSED"

NOT_APPLICABLEPAUSEDUNPAUSED

supply_keynullable Key (object)

_typeenum

Example: "ProtobufEncoded"

ECDSA_SECP256K1ED25519ProtobufEncoded

keystring

Example: 10101

supply_typeenum

Example: "INFINITE"

FINITEINFINITE

symbolstring

Example: "ORIGINALRDKSE"

token_idnullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

total_supplystring

Example: "1000000"

treasury_account_idnullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

typeenum

Example: "FUNGIBLE_COMMON"

FUNGIBLE_COMMONNON_FUNGIBLE_UNIQUE

wipe_keynullable Key (object)

_typeenum

Example: "ProtobufEncoded"

ECDSA_SECP256K1ED25519ProtobufEncoded

keystring

Example: 10101

custom_feesCustomFees (object)

created_timestampTimestamp (string)

Example: "1586567700.453054000"

Pattern: ^\d{1,10}(\.\d{1,9})?$

fixed_feesarray of FixedFee (object)

all_collectors_are_exemptboolean

Example: false

amountinteger (int64)

Example: 100

collector_account_idnullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

denominating_token_idnullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

fractional_feesarray of FractionalFee (object)

all_collectors_are_exemptboolean

Example: false

amountobject

numeratorinteger (int64)

Example: 12

denominatorinteger (int64)

Example: 29

collector_account_idnullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

denominating_token_idnullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

maximumnullable integer (int64)

Example: 120

minimuminteger (int64)

Example: 30

net_of_transfersboolean

Example: true

royalty_feesarray of RoyaltyFee (object)

all_collectors_are_exemptboolean

Example: false

amountobject

numeratorinteger (int64)

Example: 15

denominatorinteger (int64)

Example: 37

collector_account_idnullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

fallback_feeobject

amountinteger (int64)

Example: 100

denominating_token_idnullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

Request

Response

const response = await fetch('https://mainnet.hedera.validationcloud.io/v1/YOUR_API_KEY/api/v1/tokens/{tokenId}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

{
  "admin_key": {
    "_type": "ProtobufEncoded",
    "key": 10101
  },
  "auto_renew_account": "0.1.2",
  "auto_renew_period": null,
  "created_timestamp": "1586567700.453054000",
  "decimals": 1000,
  "deleted": true,
  "expiry_timestamp": 1234567890100000,
  "fee_schedule_key": {
    "_type": "ProtobufEncoded",
    "key": 10101
  },
  "freeze_default": false,
  "freeze_key": {
    "_type": "ProtobufEncoded",
    "key": 10101
  },
  "initial_supply": "1000000",
  "kyc_key": {
    "_type": "ProtobufEncoded",
    "key": 10101
  },
  "max_supply": "9223372036854775807",
  "modified_timestamp": "1586567700.453054000",
  "name": "Token name",
  "memo": "token memo",
  "pause_key": {
    "_type": "ProtobufEncoded",
    "key": 10101
  },
  "pause_status": "UNPAUSED",
  "supply_key": {
    "_type": "ProtobufEncoded",
    "key": 10101
  },
  "supply_type": "INFINITE",
  "symbol": "ORIGINALRDKSE",
  "token_id": "0.1.2",
  "total_supply": "1000000",
  "treasury_account_id": "0.1.2",
  "type": "FUNGIBLE_COMMON",
  "wipe_key": {
    "_type": "ProtobufEncoded",
    "key": 10101
  },
  "custom_fees": {
    "created_timestamp": "1586567700.453054000",
    "fixed_fees": [
      {
        "all_collectors_are_exempt": false,
        "amount": 100,
        "collector_account_id": "0.1.2",
        "denominating_token_id": "0.1.2"
      }
    ],
    "fractional_fees": [
      {
        "all_collectors_are_exempt": false,
        "amount": {
          "numerator": 12,
          "denominator": 29
        },
        "collector_account_id": "0.1.2",
        "denominating_token_id": "0.1.2",
        "maximum": 120,
        "minimum": 30,
        "net_of_transfers": true
      }
    ],
    "royalty_fees": [
      {
        "all_collectors_are_exempt": false,
        "amount": {
          "numerator": 15,
          "denominator": 37
        },
        "collector_account_id": "0.1.2",
        "fallback_fee": {
          "amount": 100,
          "denominating_token_id": "0.1.2"
        }
      }
    ]
  }
}