List Supervisors

Lists the supervisors of one node, newest first, with pagination. The node is a required query filter; it must be your own node or below it.

Required permission: supervisor:view

Request

GET /v2/admin/supervisors

Parameters

Name	Type	In	Description
node_id	string	query	Required. The node whose supervisors are listed (24-character hex id)
name	string	query	Case-insensitive partial match on the supervisor's name or surname
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/supervisors?node_id=665ae536a6392b75cfd40352&page=1&per_page=10' \
  --header 'Authorization: Bearer <access_token>'

Response

{
  "data": [
    {
      "id": "665b372f3a72d7d0791596ba",
      "name": "Jane",
      "surname": "Doe",
      "profile_photo": null,
      "email": "admin@example.com",
      "node_id": "665ae536a6392b75cfd40352",
      "role_id": "665ae79610ce216dbc35c93b",
      "identity_number": "",
      "created_at": "2025-09-05T19:26:16.294Z",
      "updated_at": "2026-10-01T08:00:12.1Z",
      "last_seen_date": "2026-11-08T17:42:03.9Z"
    }
  ],
  "total": 1,
  "page": 1,
  "per_page": 10
}

Response Fields

Field	Type	Description
data	array	The supervisors
data[].id	string	Supervisor id
data[].name	string	First name. Empty when not set
data[].surname	string	Last name. Empty when not set
data[].profile_photo	string | null	Profile photo URL
data[].email	string	Email address
data[].node_id	string	The node the supervisor belongs to
data[].role_id	string	The supervisor's role
data[].identity_number	string	Identity number. Empty when not set
data[].created_at	string	Creation time (ISO 8601)
data[].updated_at	string	Last update time (ISO 8601)
data[].last_seen_date	string	Last time the supervisor was seen (ISO 8601)
total	integer	Number of supervisors matching the filters
page	integer	Page number
per_page	integer	Items per page

Errors

Status	Code	Description
400	10015	Validation failed (missing or malformed node_id, missing page or per_page) — see details
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.