List Children Nodes

Searches for child nodes of a specific parent node with pagination support.

Request

POST /v2/admin/node/{node_id}/children/search

Parameters

Name	Type	In	Description
node_id	string	path	Required. The ID of the parent node to search children for

Headers

Name	Description
Authorization	Required. Bearer token for authentication
Content-Type	Required. Must be application/json

Request Body

Name	Type	Description
page	number	Page number for pagination (defaults to 1)
per_page	number	Number of results per page (defaults to 20)

Example

curl --request POST \
  --url '\{\{baseUrl\}\}/v2/admin/node/67d1887219270f00501b8d3f/children/search' \
  --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...' \
  --header 'Content-Type: application/json' \
  --data '{
    "page": 1,
    "per_page": 20
}'

Response

{
  "data": [
    {
      "id": "67d6c447f47ff3adafda700d",
      "parent_id": "67a68d4462dd1d00073d0af3",
      "parent_name": null,
      "name": "Tostik 5",
      "type": 2,
      "status": 1,
      "contract": {
        "wallet": {
          "public_key": "0xAF4bf547c4d354266449dB91fe0c4d8861cFfc0E"
        },
        "fee_contract_address": "0x1bD038546274fbE5656711d4E5371EE1bABCd126",
        "listing_contract_address": "0xb6627b1685d1199E3087D2247d5F432fb1721c34",
        "rent_contract_address": "0x57327F5C456B661Fc0D337473ec8F14a4ADccfb3",
        "burn_contract_address": "0x222CB82947be52A91a88B1A2E116abf4D9bA6eed",
        "secondary_contract_address": "0x8B3a9f9Ea0fA265f56D28AD9Ea0416E5b6a32011"
      },
      "meta": null,
      "int_id": 38,
      "path": "1.38",
      "listed_token_count": 0,
      "supervisor_count": 0,
      "created_at": "2025-03-16T12:29:59.46Z"
    }
  ],
  "total": 10,
  "page": 1,
  "per_page": 20
}

Response Fields

Field	Type	Description
data	array	List of child nodes
data[].id	string	Unique identifier for the child node
data[].parent_id	string	ID of the parent node
data[].parent_name	string	Name of the parent node (null if not available)
data[].name	string	Name of the child node
data[].type	number	Type code for the node
data[].status	number	Status code for the node
data[].contract	object	Contract information for the node
data[].contract.wallet.public_key	string	Public key of the node's wallet
data[].contract.fee_contract_address	string	Address of the fee contract
data[].contract.listing_contract_address	string	Address of the listing contract
data[].contract.rent_contract_address	string	Address of the rent contract
data[].contract.burn_contract_address	string	Address of the burn contract (null if not available)
data[].contract.secondary_contract_address	string	Address of the secondary contract
data[].meta	object	Metadata for the node (null if not available)
data[].int_id	number	Internal ID of the node
data[].path	string	Path hierarchy of the node
data[].listed_token_count	number	Count of listed tokens
data[].supervisor_count	number	Count of supervisors for the node
data[].created_at	string	Creation timestamp of the node
total	number	Total number of child nodes
page	number	Current page number
per_page	number	Number of items per page

Status Codes

Status Code	Description
200	Success
400	Bad Request - Invalid request body
401	Unauthorized - Invalid or missing authentication token
404	Not Found - Parent node ID does not exist
500	Internal Server Error