Get Distribution Token Info

Returns the distribution view of one token: its price with the platform's fees, sale limits, contract, the on-chain call an external market makes to buy it, the currency it is paid in, and its images and documents. Use it to list a distribution token in an external system.

The token must be a distribution token; any other token answers token not found. The read is not limited to the caller's node.

Required permission: distribution:view

Request

GET /v2/distributions/tokens/{token_id}

Parameters

Name	Type	In	Description
`token_id`	string	path	Required. The token's id on the platform (24-character hex)

Headers

Name	Description
`Authorization`	Required. `Bearer <access_token>`

Example

curl --request GET \
  --url '{{baseUrl}}/v2/distributions/tokens/67d8774e903bfcbe7eb5d93e' \
  --header 'Authorization: Bearer <access_token>'

Response

The abi string is abbreviated here; the API returns the full ABI.

{
  "standard": 0,
  "name": "Istanbul Commercial Lease #1",
  "description": "12-month lease on a commercial real estate asset located in Istanbul.",
  "symbol": "ICL",
  "contract": {
    "address": "0x073c0196e516a0e77b1c804d1825fb1bad23895d",
    "hash": "0x5c504ed432cb51138bcf09aa5e8a410dd4a1e204ef84bfed1be16dfba1b22060"
  },
  "rules": {
    "max_purchase_limit": 100,
    "min_purchase_limit": 1
  },
  "status": 2,
  "integration": {
    "network_id": 137,
    "abi": "[...]",
    "contract_address": "0x4A096E485281DE1B8bF11A511D39d5B128EF7C4b",
    "function_name": "buy",
    "currency_token_address": "0xc2132D05D31c914a87C6611C10748AEb04B58e8F",
    "is_approved": true,
    "args": [
      { "type": "bigint", "value": null, "description": "Quantity" },
      { "type": "address", "value": "0x073c0196e516a0e77b1c804d1825fb1bad23895d", "description": "TokenAddress" },
      { "type": "address", "value": "0xc2132D05D31c914a87C6611C10748AEb04B58e8F", "description": "CurrencyToken Address" },
      { "type": "string", "value": null, "description": "MarketID" }
    ]
  },
  "value": "102.5",
  "total_value": "250000",
  "supply": 2500,
  "seller_address": "0x4A096E485281DE1B8bF11A511D39d5B128EF7C4b",
  "currency_token": {
    "name": "Tether USD",
    "symbol": "USDT",
    "decimals": 6,
    "address": "0xc2132D05D31c914a87C6611C10748AEb04B58e8F"
  },
  "meta": {
    "images": [
      {
        "id": "69120e5fe5064fdeaef6f101",
        "url": "https://s3.tokenizationtr.com/tokens/67d8774e903bfcbe7eb5d93e/cover.png",
        "is_default": true,
        "hash": "9f2c4e1b7a3d58c06e2f1a4b9c7d3e5f8a0b2c4d6e8f0a1b3c5d7e9f1a2b3c4d",
        "created_at": "2026-03-16T12:29:59.46Z"
      }
    ],
    "documents": [
      {
        "id": "69120e5fe5064fdeaef6f102",
        "name": "Prospectus",
        "url": "https://s3.tokenizationtr.com/tokens/67d8774e903bfcbe7eb5d93e/prospectus.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=604800&X-Amz-Signature=...",
        "type": 6,
        "hash": "3b8e1f0c2d4a6b8e0f2a4c6e8b0d2f4a6c8e0b2d4f6a8c0e2b4d6f8a0c2e4b6d",
        "created_at": "2026-03-16T12:30:04.12Z"
      }
    ]
  },
  "external_id": "67d8774e903bfcbe7eb5d93e"
}

Response Fields

Field	Type	Description
`standard`	integer	Token standard: `0` ERC-20, `1` ERC-721, `2` ERC-1155, `3` ERC-3643, `4` ERC-4380
`name`	string	Token display name
`description`	string	Token description
`symbol`	string	Token symbol
`contract.address`	string	The token's contract address
`contract.hash`	string	Hash of the transaction that deployed the token contract
`rules.max_purchase_limit`	integer	Most tokens one purchase may buy. `0` when not set
`rules.min_purchase_limit`	integer	Fewest tokens one purchase may buy. `0` when not set
`status`	integer	Sale status: `2` when the token is listed for sale, `4` in every other state (draft, in progress, failed, not listed, delisted, burned, passive). No other value is returned
`integration`	object	The on-chain call that buys the token
`integration.network_id`	integer	EVM chain id of the token's network (e.g. `137`), not the catalog `id` used in request bodies (see Get Networks). `0` when the token has no network
`integration.abi`	string	ABI of the listing contract, as a JSON string
`integration.contract_address`	string	Address of the contract to call: the token's diamond, recorded from its node's deployment when the token was created
`integration.function_name`	string	Function to call. Always `buy`
`integration.currency_token_address`	string	Contract address of the currency the token is paid in
`integration.is_approved`	boolean	Always `true`
`integration.args`	array	Arguments of `buy`, in call order. Each has a `type` (`bigint`, `address`, `string`), a `description` and a `value`; `value` is `null` where the caller fills it in (the quantity and the market id)
`value`	string	Price of one token including the platform's fees, a decimal string (see Amounts and Percentages). Each fee recipient's share is truncated to the currency's decimals on its own and added to the unit price
`total_value`	string	Recorded value of the whole asset behind the token, without fees, a decimal string. It is not `value` × `supply`: usually only part of an asset is listed. `"0"` when no value was recorded
`supply`	integer	Number of tokens listed for sale
`seller_address`	string	Address that sells the token: the same diamond as `integration.contract_address`
`currency_token`	object	The currency the token is paid in: `name`, `symbol`, `decimals` (integer) and contract `address`. Empty strings and `0` when the currency cannot be read
`meta`	object	The token's images and documents. Omitted when the token has neither
`meta.images[]`	array	`id`, `url`, `is_default` (boolean), `hash` (SHA-256 of the file, hex) and `created_at` of each image
`meta.documents[]`	array	`id`, `name`, `url`, `type`, `hash` (SHA-256 of the file, hex) and `created_at` of each document
`meta.documents[].url`	string	Signed link to the document, valid for 7 days. Read the token again for a fresh link before it expires
`meta.documents[].type`	integer	`1` standard, `2` whitepaper, `3` terms of service, `4` privacy policy, `5` legal agreement, `6` prospectus, `7` audit report, `8` license, `9` certificate
`external_id`	string	The token's id on the platform (the same value as `token_id`). Store it to read the token again

Errors

Status	Code	Description
400	`10016`	`token_id` is not a valid 24-character hex id
400	`10001`	No token has this id, or the token is not a distribution token (domain `5`, message `token not found`)
400	`10001`	The token's category was not found (domain `4`, message `category not found`)
400	`10004`	The token has no contract (domain `5`, message `token is not listed or delist`)
400	`10014`	The token's diamond is not deployed (domain `5`, message `diamond address not exists`)
500	`10000`	Unexpected server-side failure

See Errors for the error format and common codes.

Request​

Parameters​

Headers​

Example​

Response​

Response Fields​

Errors​