post https://api.exponea.com/data/v2/projects//analyses/report
/data/v2/projects/{projectToken}/analyses/report
Retrieve calculated (materialized) results of an already existing report.
Please note that:
- Results of your analyses may contain Private data (PII)
- Results may be cached for up to 10 minutes
Definition
Authorization
In this API call you must use the following authorization access and permissions:
Available access type | Permissions needed |
---|---|
Private access | GDPR > Export analyses > Allow |
Read more about:
Path parameters
Parameter | Type | Description | Required |
---|---|---|---|
projectToken | string | The ID of your project. | Required |
Body Parameters
Parameter | Type | Description | Required |
---|---|---|---|
analysis_id | string | The ID of the report you want to retrieve. This can be found in the URL when editing an analyses. | Required |
execution_time | integer/float | To which timestamp should the report be evaluated. The default value is current time. | No |
timezone | string | Which timezone should the customer filter and attributes be evaluated on. The default value is UTC . | No |
format | string | How should the report's output be formatted.csv - Formatted as CSV table with header row.table_json - Similar to CSV format, but with data represented in JSON. | Required |
Header
Parameter | Type | Description | Required |
---|---|---|---|
authorization | string | Used for authentication. Read more in the Authentication section. | Required |
content-type | string | application/json | Required |
Response description
JSON format
Attribute | Type | Description |
---|---|---|
name | string | The name of the requested report, as displayed in the app. |
header | array | An array of column names. |
rows | array of arrays of values | Values of rows as indicated by header. |
success | boolean | Result status |
Additional payload and response examples
{
"analysis_id": "6047403995f0c479c3c7219d",
"timezone": "Europe/London",
"format": "csv"
}
first_name,count(customer)
Armani,10
Dillan,11
Green,10
June,10
Kathryn,10
Madisyn,10
Maurice,13
Maxwell,11
Terrence,11
(other),9907
{
"header": [
"first_name",
"count(customer)"
],
"name": "customer list",
"rows": [
[
"Armani",
10
],
[
"Dillan",
11
],
[
"June",
10
],
[
"Kathryn",
10
],
[
"Madisyn",
10
],
[
"Manuel",
10
],
[
"Maurice",
13
],
[
"Maxwell",
11
],
[
"Terrence",
11
],
[
"(other)",
9907
]
],
"success": true
}