Get Distribution Token Info
Returns distribution-specific information for a token by its ID: standard, sale rules, status, supply, value, currency token and integration metadata. Use this to render a distribution token in an external system.
Request
GET /v2/distributions/tokens/{tokenID}
Parameters
| Name | Type | In | Description |
|---|---|---|---|
tokenID | string | path | Required. Distribution token ID |
Headers
| Name | Description |
|---|---|
Authorization | Required. Bearer token for authentication |
Example
curl --request GET \
--url '{{baseUrl}}/v2/distributions/tokens/67d8774e903bfcbe7eb5d93e' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'
Response
{
"standard": 1,
"name": "Istanbul Commercial Lease #1",
"description": "12-month lease on a commercial real estate asset located in Istanbul...",
"symbol": "ICL",
"contract": { "address": "0x073c0196e516a0e77b1c804d1825fb1bad23895d" },
"rules": {},
"status": 1,
"integration": {},
"value": 250000,
"supply": 2500,
"seller_address": "0x4A096E485281DE1B8bF11A511D39d5B128EF7C4b",
"currency_token": {
"name": "Tether USD",
"symbol": "USDT",
"decimals": 6,
"address": "0x073c0196e516a0e77b1c804d1825fb1bad23895d"
},
"external_id": "EXT-TKN-1042"
}
Response Fields
| Field | Type | Description |
|---|---|---|
standard | integer | Token standard |
name / description / symbol | string | Token display fields |
contract | object | On-chain contract info |
rules | object | Sale / trading rules |
status | integer | Distribution token status |
value | number | Total monetary value |
supply | integer | Token supply |
seller_address | string | Seller wallet address |
currency_token | object | Currency token {name, symbol, decimals, address} |
meta | object | Optional images / documents metadata |
external_id | string | Token ID in the external system (optional) |
Status Codes
| Status Code | Description |
|---|---|
| 200 | Success |
| 400 | Bad Request - Missing or invalid tokenID |
| 401 | Unauthorized - Invalid or missing authentication token |
| 404 | Not Found - Distribution token not found |
| 500 | Internal Server Error |