Scope
data-reports:write
Request Body
{
"name": "string",
"timezone": "string",
"format": "csv",
"timespan": {
"from": "2022-03-23T11:42:17.312Z",
"to": "2022-03-23T11:42:17.312Z"
}
}
Request Fields
Field | Mandatory | Description |
---|---|---|
format | No | Format in which the report file will be created. |
name | No | Report's name. It has 256 character limit. |
timespan.from | Yes | Specifying the start |
timespan.to | Yes | Specifying the end |
timezone | Timezone in which the report timespan (from and to) will be applied. If not specified, will be used "UTC" as default value. Only IANA timezones are allowed, as mentioned in App and Data Types. |
Report Availability and Data Latency
This file will be available for download for 30 days.
The data obtained via Explore API has a 60-second delay in relation to real time.
Account-based Quota
The Explore API has an account-based quota limit of 15 simultaneous reports (executing + enqueued). If this limit is exceeded, the user will receive a 429 (too many requests) response.
A Request to Execute a Report May Fail When
- The credentials are not valid or the required scope is missing.
- The report request:
- Does not have a valid structure.
- Is missing a mandatory field.
- Some report request field has an invalid value (e.g.: invalid report format or not properly formatted date time).
- The report's end date (
timespan.to
) is:
- In the future.
- Prior to the start date (
timespan.from
).- The difference in days between the end date (
timespan.to
) and the start date (timespan.from
) is greater than 31.- The report's timezone is not a valid timezone. Only timezones that follows the IANA standard are allowed.
- The account-based quota limit of 15 simultaneous reports (executing + enqueued) has been exceeded.