View all methods
studio.reports.info
Get a Data Studio report.
Facts
| Method | GET https://api.getdx.com/studio.reports.info |
| Required scope | studio:reports:read |
Arguments
| Name | Type | Description |
|---|---|---|
token |
Token |
Auth token passed as an HTTP header. |
id |
Text |
Public ID of the report. |
Usage info
- Organization API keys can get any Data Studio report in the account.
- Personal access tokens can only get reports the token owner can view.
Example request
This is a typical request:
curl -X GET 'https://api.getdx.com/studio.reports.info?id=ou9lhoz888sa' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer xxxx-xxxxxxxxx-xxxx'
Example response
This is a typical success response:
{
"ok": true,
"report": {
"id": "ou9lhoz888sa",
"name": "Web Metrics",
"description": "Main application web visit metrics",
"markdown_notes": "## Objectives\n---\n* Provide high-level traffic metrics for marketing team\n* Surface for debugging reported web issues.",
"view_access_type": "everyone",
"edit_access_type": "read_only",
"url": "https://app.getdx.com/datacloud/studio/reports/OTEzNA",
"tiles": [
{
"id": "MTE4e2",
"title": "Median visit duration",
"sql": "SELECT avg(duration) AS avg_duration, week_start FROM custom.web_visits;",
"chart_type": "line",
"chart_config": {
"xAxis": "week_start",
"yAxes": ["avg_duration"]
}
}
],
"created_at": "2026-03-12T19:56:11Z",
"updated_at": "2026-05-12T10:46:12Z"
}
}
The report field is a Studio Report object.
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing. Callers should always check the value of the ok param in the response.
| Error | Description |
|---|---|
not_authed |
No authentication token provided, or Data Cloud is not available. |
invalid_auth |
Some aspect of authentication cannot be validated. |
not_authorized |
The bearer token does not include the required studio:reports:read scope, or the personal access token owner cannot access Data Studio. |
not_found |
No report with that ID exists, or the token owner cannot view it. |
invalid_arguments |
One or more arguments are invalid. |
too_many_requests |
Too many requests were sent in a short period of time. |