Fetch a funnel's conversion trend

GET/apps/{id}/funnels/{funnelId}/trend

Returns the funnel's conversion for each day, week or month, ending with the current one in timezone. Users are counted as in the funnel's conversion, by the period they did the first step in.

Weeks start on Monday.
Users that did the first step near the end of a period can still convert after it ends, so a period is complete once a conversion window has passed since its end.
from and to are ignored.

Authorization

bearerAuth

AuthorizationBearer <token>

User access token issued at sign-in. Sent as Authorization: Bearer <access-token> unless cookies are used to send tokens. The /auth/refresh and /auth/signout endpoints expect the session's refresh token in the same header format instead.

In: header

Path Parameters

id*string

App's UUID.

Formatuuid

funnelId*string

Funnel's UUID.

Formatuuid

Query Parameters

period*string

Length of each point of the trend.

Value in

"day"
"week"
"month"

timezone*string

IANA timezone used to bucket and format datetime values in the response. Example: Asia/Kolkata.

filter_expr?string

Conditions joined by AND or OR and grouped with parentheses, each reading key:operator:values with the names /apps/{id}/filters/keys publishes. AND binds tighter than OR.

version_name:in:[1.2.0,1.1.9] AND mapping_type:not_in:jsbundle(version_name:contains:SNAPSHOT AND mapping_type:in:proguard) OR patch_id:is_set

An operator taking no values ends its condition, as patch_id:is_set does. Double-quote a value holding a space, comma, bracket, colon or quote, with \" and \\ inside.

At most 4096 bytes, 32 conditions, 4 levels of nesting and 200 values in one condition.

builds?boolean

Set to true to include the builds and patches first uploaded during the trend.

Defaultfalse

Response Body

`application/json`

curl -X GET "https://example.com/apps/497f6eca-6276-4993-bfeb-53cbbbba6f08/funnels/497f6eca-6276-4993-bfeb-53cbbbba6f08/trend?period=day&timezone=string"

{  "event_names": [    "view_cart",    "start_checkout",    "purchase"  ],  "points": [    {      "datetime": "2026-09-28",      "steps": [        {          "users": 300,          "median_seconds_from_previous": null        },        {          "users": 160,          "median_seconds_from_previous": 92        },        {          "users": 104,          "median_seconds_from_previous": 205        }      ],      "median_seconds_to_convert": 320,      "complete": true    },    {      "datetime": "2026-10-05",      "steps": [        {          "users": 280,          "median_seconds_from_previous": null        },        {          "users": 150,          "median_seconds_from_previous": 98        },        {          "users": 90,          "median_seconds_from_previous": 215        }      ],      "median_seconds_to_convert": 340,      "complete": false    }  ],  "builds": [    {      "version_name": "1.4.0",      "version_code": "140",      "patch_id": null,      "patch_version": null,      "uploaded_at": "2026-10-01T09:12:00Z"    }  ]}