List service-level objectives

Latest Dynatrace
Reference
Published Oct 13, 2026

List service-level objectives in Dynatrace with the SLO API, using page, filter, and sort parameters to page and refine results.


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

Overview

You use page-size, page, page-key, filter, and sort to control which service-level objectives appear and how they are ordered. The response returns a paged array of service-level objectives.

Authentication

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

Parameters

Parameter	Type	Description	In	Required
page-size	integer	How many items to return at one time (max 500)	query	Optional
page	integer	The page number to retrieve, 1-indexed. Can't be used together with `page-key`.	query	Optional
page-key	string	Cursor for the next page of results, obtained from `nextPageKey` in the previous response. Can't be used together with `page`.	query	Optional
filter	string	The filter parameter, as explained here. Filtering is supported on the following fields: `id` `name` `tag.key` and `tag.value`	query	Optional
sort	string	The sort parameter, as explained here. Sorting is supported on the following fields: `name`	query	Optional

Response

Response codes

Code	Type	Description
200	SloObjectsList	A paged array of service-level objectives
400	-	-
401	-	-
403	-	-
429	-	-
5XX	-	-

Response body objects

The `SloObjectsList` object

Element Type Description

totalCount

integer

Element	Type	Description
totalCount	integer	The total number of entries in the result.
nextPageKey	string	The cursor for the next page of results. Has the value of `null` on the last page. Use it in the page-key query parameter to obtain subsequent pages of the result.
slos	Slo[]	-

The total number of entries in the result.

nextPageKey

string

The cursor for the next page of results. Has the value of null on the last page.

Use it in the page-key query parameter to obtain subsequent pages of the result.

slos Slo[] -

The `Slo` object

The `SloConfig` object

Configuration for a service-level objective. Exactly one of sliReference or customSli must be provided. Providing both or neither results in a 400 Bad Request.

Element	Type	Description
name	string	-
description	string	-
sliReference	SliReference	-
customSli	CustomSli	-
criteria	Criteria[]	-
tags	string[]	A list of tags for this SLO. Tags can be plain strings (e.g. `myTag`) or key-value pairs separated by a colon (e.g. `Stage:DEV`). To include a literal colon in a tag, escape it with a backslash (e.g. `key\:value`).
externalId	string	An optional user-provided external identifier for the SLO. Must be unique across all SLOs.

Response body JSON models

{
  "totalCount": 1,
  "nextPageKey": "string",
  "slos": [
    {
      "id": "string",
      "version": "string"
    }
  ]
}

GET

SaaS

https://{your-environment-id}.apps.dynatrace.com/platform/slo/v1/slos

Parameters

Parameter	Type	Description	In	Required
page-size	integer	How many items to return at one time (max 500)	query	Optional
page	integer	The page number to retrieve, 1-indexed. Can't be used together with `page-key`.	query	Optional
page-key	string	Cursor for the next page of results, obtained from `nextPageKey` in the previous response. Can't be used together with `page`.	query	Optional
filter	string	The filter parameter, as explained here. Filtering is supported on the following fields: `id` `name` `tag.key` and `tag.value`	query	Optional
sort	string	The sort parameter, as explained here. Sorting is supported on the following fields: `name`	query	Optional

Response

Response codes

Code	Type	Description
200	SloObjectsList	A paged array of service-level objectives
400	-	-
401	-	-
403	-	-
429	-	-
5XX	-	-

Response body objects

The `SloObjectsList` object

Element Type Description

totalCount

integer

Element	Type	Description
totalCount	integer	The total number of entries in the result.
nextPageKey	string	The cursor for the next page of results. Has the value of `null` on the last page. Use it in the page-key query parameter to obtain subsequent pages of the result.
slos	Slo[]	-

The total number of entries in the result.

nextPageKey

string

The cursor for the next page of results. Has the value of null on the last page.

Use it in the page-key query parameter to obtain subsequent pages of the result.

slos Slo[] -

The `Slo` object

The `SloConfig` object

Configuration for a service-level objective. Exactly one of sliReference or customSli must be provided. Providing both or neither results in a 400 Bad Request.

Element	Type	Description
name	string	-
description	string	-
sliReference	SliReference	-
customSli	CustomSli	-
criteria	Criteria[]	-
tags	string[]	A list of tags for this SLO. Tags can be plain strings (e.g. `myTag`) or key-value pairs separated by a colon (e.g. `Stage:DEV`). To include a literal colon in a tag, escape it with a backslash (e.g. `key\:value`).
externalId	string	An optional user-provided external identifier for the SLO. Must be unique across all SLOs.

Response body JSON models

{
  "totalCount": 1,
  "nextPageKey": "string",
  "slos": [
    {
      "id": "string",
      "version": "string"
    }
  ]
}

List service-level objectives

Overview

Authentication

Parameters

Response

Response codes

Response body objects

The SloObjectsList object

The Slo object

The SloConfig object

Response body JSON models

List service-level objectives

Overview

Authentication

Parameters

Response

Response codes

Response body objects

The SloObjectsList object

The Slo object

The SloConfig object

Response body JSON models

The `SloObjectsList` object

The `Slo` object

The `SloConfig` object

The `SloObjectsList` object

The `Slo` object

The `SloConfig` object