List synthetic monitors

Latest Dynatrace
Reference
Published Oct 13, 2026
Early Access

List synthetic monitors in Dynatrace with the Synthetic API and narrow the results with a monitor selector that matches all specified criteria.


GET	SaaS	`https://{your-environment-id}.apps.dynatrace.com/platform/synthetic/v1/monitors`

Overview

Use the monitor-selector query parameter to define the scope of the request and include only monitors that match all criteria. Dynatrace returns the synthetic monitors that satisfy your filter.

Authentication

To execute this request, you need a platform token or OAuth access token with synthetic:monitors:read scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

Parameter Type Description In Required

monitor-selector

string

Parameter	Type	Description	In	Required
monitor-selector	string	Defines the scope of the query. Only monitors matching all criteria are included in the response. You can add one or more of the criteria listed below. For each criterion you can specify multiple comma-separated values, unless stated otherwise. If several values are specified, the OR logic applies. Monitor type: `type(HTTP,NETWORK_AVAILABILITY)`. Possible values: `HTTP`, `BROWSER`, `NETWORK_AVAILABILITY`. Synthetic Location ME ID: `location(SYNTHETIC_LOCATION-123)`. Monitored entity ID: `monitors(HOST-123,FRONTEND-456,SERVICE-789)`. Accepts HOST, application (`FRONTEND`), and SERVICE entity IDs. Manually assigned application ID: `isAssignedTo(FRONTEND-123)`. Accepts application (`FRONTEND`) IDs. Monitor tags: `tag([context]key:value,key:value,key)`. Tags in `[context]key:value`, `key:value`, and `key` formats are detected and parsed automatically. If a key-only tag has a colon (`:`) in it, you must escape the colon with a backslash (`\`). Otherwise, the tag will be parsed as a `key:value` tag. All tag values are case-sensitive. Values listed within a single `tag(...)` are combined with OR. To require multiple tags (AND), specify several `tag(...)` selectors. For example, `tag(tag-a),tag(tag-b)` matches only monitors that have both tags, while `tag(tag-a,tag-b)` matches monitors that have either. Monitor enablement: `enabled(true)`. Security context: `securityContext(value1,value2)`. To set several criteria, separate them with a comma (`,`).	query	Optional

Defines the scope of the query. Only monitors matching all criteria are included in the response.

You can add one or more of the criteria listed below. For each criterion you can specify multiple comma-separated values, unless stated otherwise. If several values are specified, the OR logic applies.

Monitor type: type(HTTP,NETWORK_AVAILABILITY). Possible values: HTTP, BROWSER, NETWORK_AVAILABILITY.
Synthetic Location ME ID: location(SYNTHETIC_LOCATION-123).
Monitored entity ID: monitors(HOST-123,FRONTEND-456,SERVICE-789). Accepts HOST, application (FRONTEND), and SERVICE entity IDs.
Manually assigned application ID: isAssignedTo(FRONTEND-123). Accepts application (FRONTEND) IDs.
Monitor tags: tag([context]key:value,key:value,key). Tags in [context]key:value, key:value, and key formats are detected and parsed automatically. If a key-only tag has a colon (:) in it, you must escape the colon with a backslash (\). Otherwise, the tag will be parsed as a key:value tag. All tag values are case-sensitive. Values listed within a single tag(...) are combined with OR. To require multiple tags (AND), specify several tag(...) selectors. For example, tag(tag-a),tag(tag-b) matches only monitors that have both tags, while tag(tag-a,tag-b) matches monitors that have either.
Monitor enablement: enabled(true).
Security context: securityContext(value1,value2).

To set several criteria, separate them with a comma (,).

query

Optional

Response

Response codes

Code	Type	Description
200	SyntheticMonitorListResponse	Success
4XX	ErrorResponseEnvelope	Client side error.
5XX	ErrorResponseEnvelope	Server side error.

Response body objects

The `SyntheticMonitorListResponse` object

List of available synthetic monitors.

Element	Type	Description
monitors	SyntheticMonitorSummaryDto[]	List of monitors.

The `SyntheticMonitorSummaryDto` object

Basic monitor data.

Element	Type	Description
enabled	boolean	If true, the monitor is enabled.
id	string	Id of the monitor.
name	string	The name of the monitor.
type	string	- The element can hold these values `BROWSER` `HTTP` `NETWORK_AVAILABILITY`

The `ErrorResponseEnvelope` object

Encloses the encountered error.

Element	Type	Description
error	ErrorResponse	Basic information of the encountered error.

The `ErrorResponse` object

Basic information of the encountered error.

Element	Type	Description
code	integer	The returned HTTP status code.
details	ErrorResponseDetails	Detailed information of the error.
message	string	Description of the encountered error.

The `ErrorResponseDetails` object

Detailed information of the error.

Element	Type	Description
type	string	Defines the actual set of fields depending on the value. See one of the following objects: `constraintViolation` -> ConstraintViolationDetails The element can hold these values `constraintViolation`

Response body JSON models

{
  "monitors": [
    {
      "enabled": "true",
      "id": "NETWORK-AVAILABILITY-MONITOR-63653CB579F573D1",
      "name": "My network availability monitor",
      "type": "NETWORK_AVAILABILITY"
    },
    {
      "enabled": "false",
      "id": "NETWORK-AVAILABILITY-MONITOR-63653CB579F573D2",
      "name": "Disabled network availability monitor",
      "type": "NETWORK_AVAILABILITY"
    }
  ]
}

{
  "error": {
    "code": 1,
    "details": {
      "type": "constraintViolation"
    },
    "message": "string"
  }
}

GET

SaaS

https://{your-environment-id}.apps.dynatrace.com/platform/synthetic/v1/monitors

Parameters

Parameter Type Description In Required

monitor-selector

string

Parameter	Type	Description	In	Required
monitor-selector	string	Defines the scope of the query. Only monitors matching all criteria are included in the response. You can add one or more of the criteria listed below. For each criterion you can specify multiple comma-separated values, unless stated otherwise. If several values are specified, the OR logic applies. Monitor type: `type(HTTP,NETWORK_AVAILABILITY)`. Possible values: `HTTP`, `BROWSER`, `NETWORK_AVAILABILITY`. Synthetic Location ME ID: `location(SYNTHETIC_LOCATION-123)`. Monitored entity ID: `monitors(HOST-123,FRONTEND-456,SERVICE-789)`. Accepts HOST, application (`FRONTEND`), and SERVICE entity IDs. Manually assigned application ID: `isAssignedTo(FRONTEND-123)`. Accepts application (`FRONTEND`) IDs. Monitor tags: `tag([context]key:value,key:value,key)`. Tags in `[context]key:value`, `key:value`, and `key` formats are detected and parsed automatically. If a key-only tag has a colon (`:`) in it, you must escape the colon with a backslash (`\`). Otherwise, the tag will be parsed as a `key:value` tag. All tag values are case-sensitive. Values listed within a single `tag(...)` are combined with OR. To require multiple tags (AND), specify several `tag(...)` selectors. For example, `tag(tag-a),tag(tag-b)` matches only monitors that have both tags, while `tag(tag-a,tag-b)` matches monitors that have either. Monitor enablement: `enabled(true)`. Security context: `securityContext(value1,value2)`. To set several criteria, separate them with a comma (`,`).	query	Optional

Defines the scope of the query. Only monitors matching all criteria are included in the response.

Monitor type: type(HTTP,NETWORK_AVAILABILITY). Possible values: HTTP, BROWSER, NETWORK_AVAILABILITY.
Synthetic Location ME ID: location(SYNTHETIC_LOCATION-123).
Monitored entity ID: monitors(HOST-123,FRONTEND-456,SERVICE-789). Accepts HOST, application (FRONTEND), and SERVICE entity IDs.
Manually assigned application ID: isAssignedTo(FRONTEND-123). Accepts application (FRONTEND) IDs.
Monitor tags: tag([context]key:value,key:value,key). Tags in [context]key:value, key:value, and key formats are detected and parsed automatically. If a key-only tag has a colon (:) in it, you must escape the colon with a backslash (\). Otherwise, the tag will be parsed as a key:value tag. All tag values are case-sensitive. Values listed within a single tag(...) are combined with OR. To require multiple tags (AND), specify several tag(...) selectors. For example, tag(tag-a),tag(tag-b) matches only monitors that have both tags, while tag(tag-a,tag-b) matches monitors that have either.
Monitor enablement: enabled(true).
Security context: securityContext(value1,value2).

To set several criteria, separate them with a comma (,).

query

Optional

Response

Response codes

Code	Type	Description
200	SyntheticMonitorListResponse	Success
4XX	ErrorResponseEnvelope	Client side error.
5XX	ErrorResponseEnvelope	Server side error.

Response body objects

The `SyntheticMonitorListResponse` object

List of available synthetic monitors.

Element	Type	Description
monitors	SyntheticMonitorSummaryDto[]	List of monitors.

The `SyntheticMonitorSummaryDto` object

Basic monitor data.

Element	Type	Description
enabled	boolean	If true, the monitor is enabled.
id	string	Id of the monitor.
name	string	The name of the monitor.
type	string	- The element can hold these values `BROWSER` `HTTP` `NETWORK_AVAILABILITY`

The `ErrorResponseEnvelope` object

Encloses the encountered error.

Element	Type	Description
error	ErrorResponse	Basic information of the encountered error.

The `ErrorResponse` object

Basic information of the encountered error.

Element	Type	Description
code	integer	The returned HTTP status code.
details	ErrorResponseDetails	Detailed information of the error.
message	string	Description of the encountered error.

The `ErrorResponseDetails` object

Detailed information of the error.

Element	Type	Description
type	string	Defines the actual set of fields depending on the value. See one of the following objects: `constraintViolation` -> ConstraintViolationDetails The element can hold these values `constraintViolation`

Response body JSON models

{
  "monitors": [
    {
      "enabled": "true",
      "id": "NETWORK-AVAILABILITY-MONITOR-63653CB579F573D1",
      "name": "My network availability monitor",
      "type": "NETWORK_AVAILABILITY"
    },
    {
      "enabled": "false",
      "id": "NETWORK-AVAILABILITY-MONITOR-63653CB579F573D2",
      "name": "Disabled network availability monitor",
      "type": "NETWORK_AVAILABILITY"
    }
  ]
}

{
  "error": {
    "code": 1,
    "details": {
      "type": "constraintViolation"
    },
    "message": "string"
  }
}

List synthetic monitors

Overview

Authentication

Parameters

Response

Response codes

Response body objects

The SyntheticMonitorListResponse object

The SyntheticMonitorSummaryDto object

The ErrorResponseEnvelope object

The ErrorResponse object

The ErrorResponseDetails object

Response body JSON models

List synthetic monitors

Overview

Authentication

Parameters

Response

Response codes

Response body objects

The SyntheticMonitorListResponse object

The SyntheticMonitorSummaryDto object

The ErrorResponseEnvelope object

The ErrorResponse object

The ErrorResponseDetails object

Response body JSON models

The `SyntheticMonitorListResponse` object

The `SyntheticMonitorSummaryDto` object

The `ErrorResponseEnvelope` object

The `ErrorResponse` object

The `ErrorResponseDetails` object

The `SyntheticMonitorListResponse` object

The `SyntheticMonitorSummaryDto` object

The `ErrorResponseEnvelope` object

The `ErrorResponse` object

The `ErrorResponseDetails` object