Get Token Details

Retrieves detailed information about a specific token.

Request

GET /v2/admin/token/{token_id}

Parameters

Name	Type	In	Description
token_id	string	path	Required. The ID of the token to retrieve

Headers

Name	Description
Authorization	Required. Bearer token for authentication

Example

curl --request GET \
  --url '\{\{baseUrl\}\}/v2/admin/token/67d8774e903bfcbe7eb5d93e' \
  --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...' \
  --header 'User-Agent: insomnia/10.3.1'

Response

{
	"id": "67d8774e903bfcbe7eb5d93e",
	"category_id": "667e9251ca818a2138ed4915",
	"node_id": "67d6c447f47ff3adafda700d",
	"status": 4,
	"is_public": false,
	"is_open_to_secondary_market": false,
	"name": "TKN Token Name 6 Updated",
	"description": "Token Description 222",
	"token_name": "tkn",
	"token_symbol": "TKN",
	"meta": {
		"images": [
			{
				"id": "67d8aac52b32e33603246a1f",
				"url": "https://fra1.digitaloceanspaces.com/apex/dev/token/67d8774e903bfcbe7eb5d93e/images/9fa561ea-d5c6-494a-ab1f-8aeabe211e7e.jpeg",
				"is_default": false,
				"hash": "b9edd305d6e628fa06f4f2ae33f649cb9b57cbbc4156cde981fef512df3367ab",
				"created_at": "2025-03-17T23:05:41.969Z",
				"deleted_at": null
			}
		],
		"documents": [
			{
				"id": "67d8aac62b32e33603246a20",
				"name": "Ws_20240201.pdf",
				"url": "https://fra1.digitaloceanspaces.com/apex/dev/token/67d8774e903bfcbe7eb5d93e/documents/47ffece9-4d07-4c14-a422-144ab6832df1.pdf",
				"type": 1,
				"hash": "cdb85002d5c946b618bbf9694916df129d1f570e2e763c117de425383c83af58",
				"created_at": "2025-03-17T23:05:42.97Z",
				"deleted_at": null
			}
		]
	},
	"contract": {
		"address": "0xaffdea8c3fdd521681bb5e7d44e3ae57871093e4",
		"tx_hash": "0x998a217061da05cf1bf1998470613a488b10908f0964e76a123c4063f91d77c4"
	},
	"node_contract": {
		"listing_contract_address": "0xb6627b1685d1199E3087D2247d5F432fb1721c34",
		"rent_contract_address": "0x57327F5C456B661Fc0D337473ec8F14a4ADccfb3",
		"burn_contract_address": "0x222CB82947be52A91a88B1A2E116abf4D9bA6eed"
	},
	"value": {
		"value": {
			"amount": 12000,
			"decimal": 6,
			"symbol": "USDT"
		},
		"rate": 30,
		"salable_value": 3600,
		"additional_supply": 0,
		"total_supply": 0,
		"max_supply": 1000,
		"sold_supply": 0
	},
	"metric": null,
	"created_at": "2025-03-17T19:26:06.562Z",
	"updated_at": "2025-03-17T23:06:06.098Z",
	"deleted_at": null
}

Status Codes

Status Code	Description
200	Success
401	Unauthorized - Invalid or missing authentication token
404	Not Found - Token ID does not exist
500	Internal Server Error

Token Status

The status field in the response indicates the current state of the token in the system. Below are the possible status values:

Status Code	Status Name	Description
1	Draft	Initial state of the token before blockchain deployment. Token details are saved but not yet submitted to the blockchain.
2	InProgress	Token is in the process of being deployed to the blockchain. Transactions are pending.
3	Error	An error occurred during token deployment or transaction processing. The blockchain operation failed.
4	NotListed	Token has been successfully deployed to the blockchain but is not yet listed on the marketplace.
5	Delisted	Token was previously listed but has been removed from the marketplace.
6	Listed	Token is successfully deployed and actively listed on the marketplace.
7	Passive	Token is in an inactive state. It exists on the blockchain but is not actively tradable.
8	Burn	Token has been permanently burned/destroyed on the blockchain.