Get Node

Retrieves information about a specific node in the system.

Request

GET /v2/admin/node/{node_id}

Parameters

Name	Type	In	Description
node_id	string	path	Required. The ID of the node to retrieve

Headers

Name	Description
Authorization	Required. Bearer token for authentication

Example

curl --request GET \
  --url '\{\{baseUrl\}\}/v2/admin/node/67d6bc4c79cbf60512347a29' \
  --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...' \

Response

{
	"id": "67d6bc4c79cbf60512347a29",
	"parent_id": "67a68d4462dd1d00073d0af3",
	"parent_name": "Hiper Token",
	"name": "Tostik 4",
	"type": 2,
	"status": 3,
	"contract": {
		"wallet": {
			"public_key": "0x86123D7398a5a2C8b847b37B34eB499e07dE3A76"
		},
		"fee_contract": {
			"address": "0x10FfF7e0Ff052cEb569CFA74adc34469E1EFbDF8",
			"version": "v2.0.0",
			"node_contract_id": "67d6bc4c79cbf60512347a29"
		},
		"listing_contract": {
			"address": "0xCBF3016C00C86979D4d395aDBF04C319dAD923b0",
			"version": "v2.0.0",
			"node_contract_id": "67d6bc4c79cbf60512347a29"
		},
		"rent_contract": {
			"address": "0x88DF676a04639B723C00D995004BbD133f766aEF",
			"version": "v2.0.0",
			"node_contract_id": "67d6bc4c79cbf60512347a29"
		},
		"burn_contract": null,
		"secondary_contract": {
			"address": "0x298ab9290c81fdb0847c5ED02Df2809343C8c2A3",
			"version": "v2.0.0",
			"node_contract_id": "67d6bc4c79cbf60512347a29"
		}
	},
	"meta": null,
	"int_id": 37,
	"path": "1.37",
	"listed_token_count": 0,
	"supervisor_count": 0,
	"created_at": "2025-03-16T11:55:56.532Z"
}

Response Fields

Field	Type	Description
id	string	Unique identifier of the node
parent_id	string	ID of the parent node
parent_name	string	Name of the parent node
name	string	Name of the node
type	integer	Type of the node
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
path	string	Path representation of the node hierarchy
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
404	Not Found - Node ID does not exist
500	Internal Server Error