Synthetic nodes API - GET all nodes

Lists all synthetic nodes (and their parameters) available for your environment.

The request produces an application/json payload.

Early Adopter

This request is an Early Adopter release and may be changed in non-compatible way.

  • Managed https://{your-domain}/e/{your-environment-id}/api/v1/synthetic/nodes
  • SaaS https://{your-environment-id}


To execute this request, you need the Access problem and event feed, metrics, and topology (DataExport) permission assigned to your API token. To learn how to obtain and use it, see Tokens and authentication.


The request doesn't provide any configurable parameters.

Response format

The Nodes object

A list of synthetic nodes

Element Type Description
nodes NodeCollectionElement[]

A list of synthetic nodes

The NodeCollectionElement object

The short representation of a synthetic object. Only contains the ID and the display name.

Element Type Description
entityId string

The ID of a node.

hostname string

The hostname of a node.

ips string[]

The IP of a node.

version string

The version of a node

browserMonitorsEnabled boolean

Browser check capabilities enabled flag.

activeGateVersion string

The version of the Active Gate.

oneAgentRoutingEnabled boolean

The Active Gate has the One Agent routing enabled ('true') or not ('false').

operatingSystem string

The Active Gate's host operating system.

autoUpdateEnabled boolean

The Active Gate has the Auto update option enabled ('true') or not ('false')

status string

The status of the synthetic node.

playerVersion string

The version of the synthetic player.

healthCheckStatus string

The health check status of the synthetic node.


In this example, the request lists all synthetic nodes available in the mySampleEnv environment.

The API token is passed in the Authorization header.

The result is truncated to three entries.


curl -X GET \ \
  -H 'Authorization: Api-Token abcdefjhij1234567890'

Request URL

Response body

  "nodes": [
      "entityId": "3086117876",
      "hostname": "gdn.dyna.trace",
      "ips": [
      "version": "",
      "browserMonitorsEnabled": false
      "entityId": "1267320067",
      "hostname": "",
      "ips": [
      "version": "",
      "browserMonitorsEnabled": false
      "entityId": "353074222",
      "hostname": "GDN-007",
      "ips": [
      "version": "",
      "browserMonitorsEnabled": true

Response code