List Children Nodes

Lists the direct children of a node, newest first, with pagination. For every node below a node at any depth use List Node Descendants.

Required permission: node:children:view

Request

GET /v2/admin/nodes/{node_id}/children

Parameters

Name	Type	In	Description
node_id	string	path	Required. The parent node's id
name	string	query	Case-insensitive partial match on the child's name
page	integer	query	Required. Page number, starting at 1
per_page	integer	query	Required. Items per page, 1–100

Headers

Name	Description
Authorization	Required. Bearer <access_token>

Example

curl --request GET \
  --url '{{baseUrl}}/v2/admin/nodes/665ae536a6392b75cfd40352/children?page=1&per_page=20' \
  --header 'Authorization: Bearer <access_token>'

Response

{
  "data": [
    {
      "id": "6a4bef2b1e781b11c22e9707",
      "parent_id": "665ae536a6392b75cfd40352",
      "parent_name": null,
      "name": "Tostik 5",
      "type": 2,
      "status": 2,
      "contract": null,
      "meta": null,
      "int_id": 38,
      "path": "1.38",
      "listed_token_count": 3,
      "supervisor_count": 2,
      "created_by": "665b372f3a72d7d0791596ba",
      "created_at": "2026-03-16T12:29:59.46Z"
    }
  ],
  "total": 1,
  "page": 1,
  "per_page": 20
}

Response Fields

Field	Type	Description
data	array	The child nodes. Each row has the fields of a node on Get Node, with the differences below
data[].parent_name	null	Always null in this listing
data[].status	integer	Not the stored node status, see the note below
data[].created_by_supervisor	—	Not included in this listing (created_by still is)
total	integer	Number of children matching the filter
page	integer	Page number
per_page	integer	Items per page

status in this listing

This listing replaces each child's status with a derived value: 1 when the child's legacy embedded contract set is complete, 2 otherwise. Contracts now live on setups, so every row currently reports 2. Read a child with Get Node for its real status.

Errors

Status	Code	Description
400	10015	Validation failed (for example a missing page or per_page) — see details
400	10016	node_id is not a valid id
400	10001	Node not found (node domain 2)
403	10005	The node is outside your part of the hierarchy (node domain 2)

See Errors for the error format and common codes.