Fetch a funnel's weekly cadence

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

Returns, for each hour of the week in timezone, how many users did the funnel's first step in that hour and how many of them converted. Users are counted by installation id.

The weeks end at the start of the latest week whose users have all had a full conversion window, so every hour is counted the same number of times and no user is still converting.
Hours without users are left out.
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

weeks*integer

Number of weeks to count.

Range1 <= value <= 12

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.

Response Body

`application/json`

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

{  "from": "2026-09-14T00:00:00+05:30",  "to": "2026-10-12T00:00:00+05:30",  "hours": [    {      "weekday": 1,      "hour": 9,      "users": 48,      "converted": 17    },    {      "weekday": 1,      "hour": 10,      "users": 62,      "converted": 25    }  ]}