Retrieve reports

/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 typePermissions needed
Private accessGDPR > Export analyses > Allow

Read more about:

Path parameters

ParameterTypeDescriptionRequired
projectTokenstringThe ID of your project.Required

Body Parameters

ParameterTypeDescriptionRequired
analysis_idstringThe ID of the report you want to retrieve. This can be found in the URL when editing an analyses.Required
execution_timeinteger/floatTo which timestamp should the report be evaluated. The default value is current time.No
timezonestringWhich timezone should the customer filter and attributes be evaluated on. The default value is UTC.No
formatstringHow 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

ParameterTypeDescriptionRequired
authorizationstringUsed for authentication. Read more in the Authentication section.Required
content-typestringapplication/jsonRequired

Response description

JSON format

AttributeTypeDescription
namestringThe name of the requested report, as displayed in the app.
headerarrayAn array of column names.
rowsarray of arrays of valuesValues of rows as indicated by header.
successbooleanResult 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
}
Language
Click Try It! to start a request and see the response here!