Retrieve funnels

/data/v2/projects/{projectToken}/analyses/funnel

Retrieve calculated (materialized) results of an already existing funnel.

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 funnel you want to retrieve. This can be found in the URL when editing an analyses.Required
execution_timestringTo which timestamp should the funnel 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 funnel 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 funnel, as displayed in the app.
headerarray of stringNames of the columns.
Column "serie" can be "Total" or name of drilldown parameter.
Other columns represent individual steps actual value or durations.
rowsarray of arrays of valuesValues of rows as indicated by header.
successbooleanResult status

Additional payload and response examples

{
 "analysis_id": "606451761e01abb0d591a5a7",
 "timezone": "Europe/Bratislava",
 "format": "csv"
}
serie,step 1 purchase count,step 2 purchase count,step 2 purchase duration from previous
Total,3,1,17
online,2,1,17
store,1,0,-1
{
    "header": [
        "serie",
        "step 1 purchase count",
        "step 2 purchase count",
        "step 2 purchase duration from previous"
    ],
    "name": "repurchase funnel",
    "rows": [
        [
            "Total",
            3,
            1,
            17
        ],
        [
            "online",
            2,
            1,
            17
        ],
        [
            "store",
            1,
            0,
            -1
        ]
    ],
    "success": true
}
Language
Click Try It! to start a request and see the response here!