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

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 segmentation you want to retrieve. This can be found in the URL when editing an analyses.	Required
execution_time	string	To which timestamp should the segmentation 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 segmentation'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 segmentation, as displayed in the app.
header	array of string	Names of the columns. "segment", segment metrics, and "#" as total segment size.
rows	array of arrays of values	Values of rows as indicated by header.
success	boolean	Result status

Additional payload and response examples

{
    "analysis_id": "606488856f8cf6f848b20af8",
    "timezone": "Europe/Bratislava",
    "format": "csv"
}

segment,count(purchase),avg(purchase.total_price),#
online buyers,3,64.66666666666667,2
offline buyers,1,65,1

{
    "header": [
        "segment",
        "count(purchase)",
        "avg(purchase.total_price)",
        "#"
    ],
    "name": "buyers by source",
    "rows": [
        [
            "online buyers",
            3,
            64.66666666666667,
            2
        ],
        [
            "offline buyers",
            1,
            65,
            1
        ]
    ],
    "success": true
}