Reports API - GET all reports
Lists all available reports of the specified type.
The request produces an application/json
payload.
GET | ManagedDynatrace for Government | https://{your-domain}/e/{your-environment-id}/api/config/v1/reports |
SaaS | https://{your-environment-id}.live.dynatrace.com/api/config/v1/reports | |
Environment ActiveGate | https://{your-activegate-domain}:9999/e/{your-environment-id}/api/config/v1/reports |
Authentication
To execute this request, you need an access token with ReadConfig
scope.
To learn how to obtain and use it, see Tokens and authentication.
Parameters
Parameter | Type | Description | In | Required |
---|---|---|---|---|
type | string | Type of a report.
| query | optional |
sourceId | string | Referencing source entity of a report (e.g. dashboard). | query | optional |
Response
Response codes
Code | Type | Description |
---|---|---|
200 | ReportStubList | Success |
Response body objects
The ReportStubList
object
A list of short representations of reports.
Element | Type | Description |
---|---|---|
values | DashboardReportStub[] | A list of reports. |
The DashboardReportStub
object
A short representations of the report.
Element | Type | Description |
---|---|---|
dashboardId | string | The ID of the associated dashboard. |
id | string | The ID of the report. |
type | string | The type of the report.
|
Response body JSON model
1{2 "values": [3 {4 "dashboardId": "9eee7ed6-a125-4d9d-bfa7-afdb3404cb36",5 "id": "337d883e-98c3-4dac-b8f2-1a9cdbd05969",6 "type": "DASHBOARD"7 },8 {9 "dashboardId": "26ccd360-828c-4d83-a65e-040ddc31e8f6",10 "id": "b059e372-0b35-4d44-869b-95c326748848",11 "type": "DASHBOARD"12 }13 ]14}
Example
In this example, the request asks for a list of all the report configurations in the mySampleEnv environment.
The API token is passed in the Authorization header.
The result is truncated to three entries.
Curl
1curl -X GET \2 https://mySampleEnv.live.dynatrace.com/api/config/v1/reports/ \3 -H 'Accept: application/json; charset=utf-8' \4 -H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'
Request URL
1https://mySampleEnv.live.dynatrace.com/api/config/v1/reports/
Response body
1{2 "values": [3 {4 "id": "3ad7dece-98a4-4cc4-8805-34dcd19d4714",5 "type": "DASHBOARD",6 "dashboardId": "18d5b111-05ed-4efb-8cf1-e8dd0a9e5c47"7 },8 {9 "id": "81c86de0-95d6-42d1-ad50-8578bb688b1c",10 "type": "DASHBOARD",11 "dashboardId": "bf0aad45-3785-444f-88d3-21e547eb78b1"12 },13 {14 "id": "0b2e3121-4f8d-4b08-a879-3047e044ba4c",15 "type": "DASHBOARD",16 "dashboardId": "b6570e01-1d49-4bcc-a3bb-2fab2906512c"17 }18 ]19}
Response code
200