Dynatrace platform subscription API v1 - GET subscriptions

Lists all Dynatrace platform subscriptions of an account.

The request produces an application/json payload.

GET	`https://api.dynatrace.com/sub/v1/accounts/{accountUuid}/subscriptions`

Authentication

To execute this request, you need the Allow read access for usage and consumption resources (account-uac-read) scope assigned to your token. To learn how to obtain and use it, see Authentication.

Parameters

Parameter	Type	Description	In	Required
accountUuid	string	The ID of the required account. You can find the UUID on the Account > Account management API page, during creation of an OAuth client.	path	required

Parameter

Type

Description

Required

accountUuid

string

The ID of the required account.

You can find the UUID on the Account > Account management API page, during creation of an OAuth client.

path

required

Response

Response codes

Code	Type	Description
200	ClaSubscriptionListDto	Success. The response contains a list of the account's subscriptions.

Response body objects

The `ClaSubscriptionListDto` object

Element	Type	Description
totalCount	number	The number of entries in the list.
records	ClaSubscriptionDto[]	A list of subscriptions of the account.

The `ClaSubscriptionDto` object

Element	Type	Description
subscriptionId	number	The ID of the Dynatrace Platform Subscription.
start	string	The start date and time of the subscription in `2021-05-01T15:11:00Z` format.
end	string	The end date and time of the subscription in `2021-05-01T15:11:00Z` format.

Response body JSON model

{
  "totalCount": 1,
  "records": [
    {
      "subscriptionId": 1,
      "start": "string",
      "end": "string"
    }
  ]
}

Example

In this example, the request lists all subscriptions of the 2b794097-8ad2-4b32-b923-0131da2eeddf account.

curl --request GET \
  --url 'https://api.dynatrace.com/sub/v1/accounts/2b794097-8ad2-4b32-b923-0131da2eeddf/subscriptions' \
  --header 'Authorization: Bearer abcdefjhij1234567890'

Request URL

https://api.dynatrace.com/sub/v1/accounts/2b794097-8ad2-4b32-b923-0131da2eeddf/subscriptions

Response body

{
  "totalCount": 1,
  "records": [
    {
      "subscriptionId": 40655,
      "start": "2020-07-23T00:00:00Z",
      "end": "2022-04-22T23:59:59Z"
    }
  ]
}