Try it free

List Extensions 2.0

  • Latest Dynatrace
  • Reference
  • Published Oct 13, 2026

List Extensions 2.0 available in Dynatrace with the Extensions 2.0 API, and page, filter, or add fields to the response.

GETSaaShttps://{your-environment-id}.apps.dynatrace.com/platform/extensions/v2/extensions

Overview

You can use page-size, page-key, filter, and add-fields to control which Extensions 2.0 appear and how the results are returned. The operation returns a success response with the extensions list.

Authentication

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

Parameters

ParameterTypeDescriptionInRequired
page-sizeinteger

The amount of extensions in a single response payload.

The maximal allowed page size is 100.

If not set, 20 is used.

queryOptional
page-keystring

The cursor for the next page of results. You can find it in the next-page-key field of the previous response.

The first page is always returned if you don't specify the page-key query parameter.

When the page-key is set to obtain subsequent pages, you must omit all other query parameters.

queryOptional
filterstring

The filter parameter, as explained here.

Filtering is supported on the following fields:

  • name
  • markedForDeletion

This filter supports all type operators as well as logical operators 'AND' and 'OR'. 'NOT' operator and parentheses aren't supported.

queryOptional
add-fieldsstring

Comma separated list of additional fields to include in the response. Available fields:

  • activeVersion - includes the active version of the Extension 2.0 in the environment.
  • keywords - includes the keywords of the Extension 2.0.
  • markedForDeletion - includes the markedForDeletion flag of the Extension 2.0 in the environment, which indicates that the extension is being deleted and cannot be updated or installed until the deletion process is completed.
queryOptional

Response

Response codes

CodeTypeDescription
200ExtensionInfoList

Success.

4XXErrorEnvelope

Client error.

5XXErrorEnvelope

Server error.

Response body objects

The ExtensionInfoList object

A list of extensions with additional metadata.

ElementTypeDescription
itemsExtensionInfo[]

A list of extensions with additional metadata.

nextPageKeystring

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.

pageSizeinteger

The number of entries per page.

totalCountinteger

The total number of entries in the result.

The ExtensionInfo object

A list of extensions with additional metadata.

ElementTypeDescription
activeVersionstring

Active version in the environment (null if none is active)

extensionNamestring

Extension name

keywordsstring[]

Extension keywords for the highest version

markedForDeletionboolean

Indicates if the extension is marked for deletion

versionstring

Highest installed version

The ErrorEnvelope object

ElementTypeDescription
errorError-

The Error object

ElementTypeDescription
codeinteger

The HTTP status code.

detailsErrorDetails

The error details.

messagestring

The error message.

The ErrorDetails object

The error details.

ElementTypeDescription
constraintViolationsConstraintViolation[]

A list of constraint violations.

The ConstraintViolation object

A list of constraint violations.

ElementTypeDescription
locationstring-
messagestring-
parameterLocationstring-
The element can hold these values
  • HEADER
  • PATH
  • PAYLOAD_BODY
  • QUERY
pathstring-

Response body JSON models

{
"items": [
{
"activeVersion": "1.2.3",
"extensionName": "string",
"keywords": [
"string"
],
"markedForDeletion": true,
"version": "1.2.3"
}
],
"nextPageKey": "string",
"pageSize": 1,
"totalCount": 1
}
{
"error": {
"code": 1,
"details": {
"constraintViolations": [
{
"location": "string",
"message": "string",
"parameterLocation": "HEADER",
"path": "string"
}
]
},
"message": "string"
}
}
Related tags
Platform APIDynatrace PlatformInfrastructure Observability