Retrieve reports

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
formatstring

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

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
}
Path Params
string
required
Defaults to 12345678-1234-1234-1234-123456789abc
Body Params
string
required
Defaults to 6047403995f0c479c3c7219d
string
Defaults to Europe/London
string
required
Defaults to table_json
Headers
string
required
Defaults to Basic <APIKeyID/APISecret>
Response

Language
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

© Bloomreach, Inc. All rights reserved.