• Home
  • API
  • Account management
  • Dynatrace Platform Subscription
  • Usage
  • GET usage

Dynatrace Platform Subscription API - GET usage

Gets the aggregated usage data for a Dynatrace Platform Subscription.

The request produces an application/json payload.

GET

https://api.dynatrace.com/sub/v2/accounts/{accountUuid}/subscriptions/{subscriptionUuid}/usage

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

ParameterTypeDescriptionInRequired
accountUuidstring

The ID of the required account.

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

pathrequired
subscriptionUuidstring

The UUID of the requested subscription

pathrequired
environmentIdsstring[]-queryoptional
capabilityKeysstring[]-queryoptional

Response

Response codes

CodeTypeDescription
200SubscriptionUsageListDto-
400

The request was unacceptable, often due to missing a required parameter

401

The bearer token is incorrect/expired or the requested account information does not match the bearer token

403

Access denied

404

The requested resource was not found

500

Something went wrong on Account Management API's end

Response body objects

The SubscriptionUsageListDto object

ElementTypeDescription
dataSubscriptionUsageDto[]

Subscription usage data

lastModifiedTimestring

The time the subscription data was last modified in 2021-05-01T15:11:00Z format.

The SubscriptionUsageDto object

ElementTypeDescription
capabilityKeystring

The capability key

capabilityNamestring

The name of the capability

startTimestring

The start time of the capability usage in 2021-05-01T15:11:00Z format.

endTimestring

The end time of the capability usage in 2021-05-01T15:11:00Z format.

valuenumber

The usage for the capability

unitMeasurestring

The unit of measure for the capability usage

Response body JSON model

json
{ "data": [ { "capabilityKey": "string", "capabilityName": "string", "startTime": "string", "endTime": "string", "value": 1, "unitMeasure": "string" } ], "lastModifiedTime": "string" }