Try it free

List Extension 2.0 versions

  • Latest Dynatrace
  • Reference
  • Published Oct 13, 2026

List all versions of an Extension 2.0 in Dynatrace with the Extensions 2.0 API, using the extension name and pagination controls.

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

Overview

You provide the extension-name path parameter to choose the Extension 2.0 and can use page-size and page-key to page through versions. The operation returns a success response with the version 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
extension-namestring

The name of the requested Extension 2.0.

pathRequired

Response

Response codes

CodeTypeDescription
200ExtensionList

Success.

4XXErrorEnvelope

Client error.

5XXErrorEnvelope

Server error.

Response body objects

The ExtensionList object

A list of extensions.

ElementTypeDescription
itemsMinimalExtension[]

A list of extensions.

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 MinimalExtension object

A list of extensions.

ElementTypeDescription
extensionNamestring

Extension name

versionstring

Extension 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": [
{
"extensionName": "string",
"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