Get Root Node
Retrieves information about the root node of the system.
Request
GET /v2/admin/node/root
Headers
| Name | Description |
|---|---|
Authorization | Required. Bearer token for authentication |
Example
curl --request GET \
--url '\{\{baseUrl\}\}/v2/admin/node/root' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...' \
Response
{
"id": "665ae536a6392b75cfd40352",
"parent_id": null,
"parent_name": null,
"name": "Apex",
"type": 1,
"status": 1,
"contract": {
"wallet": {
"public_key": "0xe29b892635672E59F102bf077fA9EDef64D2dA1A"
},
"fee_contract": null,
"listing_contract": null,
"rent_contract": null,
"burn_contract": null,
"secondary_contract": null,
"otc_contract": null,
"diamond_cut_facet": null,
"diamond": null,
"diamond_loupe_facet": null,
"ownership_facet": null,
"forwarder_facet": null,
"kyc_token_contract": null
},
"meta": null,
"int_id": 1,
"path": "1",
"listed_token_count": 0,
"supervisor_count": 0,
"created_at": "2023-09-05T19:26:16.294Z"
}
Response Fields
| Field | Type | Description |
|---|---|---|
id | string | Unique identifier of the root node |
parent_id | string | Always null for root node |
parent_name | string | Always null for root node |
name | string | Name of the root node (Apex) |
type | integer | Type of the node (1 for root) |
status | integer | Status code of the node |
contract | object | Contract details for the node |
contract.wallet.public_key | string | Public key of the node's wallet |
contract.fee_contract | object/null | Fee contract information (ContractInfo object, may be null) |
contract.listing_contract | object/null | Listing contract information (ContractInfo object, may be null) |
contract.rent_contract | object/null | Rent contract information (ContractInfo object, may be null) |
contract.burn_contract | object/null | Burn contract information (ContractInfo object, may be null) |
contract.secondary_contract | object/null | Secondary contract information (ContractInfo object, may be null) |
contract.otc_contract | object/null | OTC contract information (ContractInfo object, may be null) |
contract.diamond_cut_facet | object/null | Diamond cut facet contract information (ContractInfo object, may be null) |
contract.diamond | object/null | Diamond contract information (ContractInfo object, may be null) |
contract.diamond_loupe_facet | object/null | Diamond loupe facet contract information (ContractInfo object, may be null) |
contract.ownership_facet | object/null | Ownership facet contract information (ContractInfo object, may be null) |
contract.forwarder_facet | object/null | Forwarder facet contract information (ContractInfo object, may be null) |
contract.kyc_token_contract | object/null | KYC token contract information (ContractInfo object, may be null) |
ContractInfo Object Fields
| Field | Type | Description |
|---|---|---|
address | string | Contract address on the blockchain |
version | string | Contract version (e.g., "v2.0.0") |
node_contract_id | string | ID of the NodeContract document this contract belongs to |
meta | object | Additional metadata (may be null) |
int_id | integer | Internal ID of the node (always 1 for root) |
path | string | Path representation of the node hierarchy (always "1" for root) |
listed_token_count | integer | Number of tokens listed under the node |
supervisor_count | integer | Number of supervisors associated with the node |
created_at | string | ISO 8601 timestamp of when the node was created |
Status Codes
| Status Code | Description |
|---|---|
| 200 | Success |
| 401 | Unauthorized - Invalid or missing authentication token |
| 500 | Internal Server Error |