Fetch an app's sessions

GET/apps/{id}/sessions

Fetch an app's sessions, optionally narrowed by a filter expression.

Pass limit and offset values to paginate results.

In the response, meta.next / meta.previous are booleans indicating whether more pages exist in the respective direction. events is always null in list responses; it is populated only on the single-session detail endpoint. duration is the session duration in milliseconds.

Sessions that contain only a session start event, with no other activity, are always excluded from results regardless of filters.

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

Query Parameters

from?string

ISO 8601 UTC string in milliseconds precision. Example: 2023-11-01T18:30:00.000Z. Omitting both from and to returns the last seven days.

to?string

ISO 8601 UTC string in milliseconds precision. Example: 2023-11-01T18:30:00.000Z. Omitting both from and to returns the last seven days.

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.

offset?integer

Number of items to skip when paginating. Use with limit parameter to control amount of items fetched.

limit?integer

Number of items to return. Used for pagination. Should be used along with offset.

Response Body

`application/json`

curl -X GET "https://example.com/apps/497f6eca-6276-4993-bfeb-53cbbbba6f08/sessions"

{  "meta": {    "next": true,    "previous": false  },  "results": [    {      "session_id": "295842e1-7cd9-4ca3-8545-d6a5b36be9a4",      "app_id": "36e1b948-3a0a-4e71-80f3-625e61d6c832",      "attribute": {        "installation_id": "00000000-0000-0000-0000-000000000000",        "app_version": "0.8.0-SNAPSHOT.debug",        "app_build": "800",        "device_name": "emu64a16k",        "device_model": "sdk_gphone16k_arm64",        "device_manufacturer": "Google",        "os_name": "android",        "os_version": "35"      },      "events": null,      "first_event_time": "2024-10-26T05:52:43.104Z",      "last_event_time": "2024-10-26T05:53:58.596Z",      "duration": 75492    },    {      "session_id": "2cc9ffd2-9f9d-40a7-9f55-d802a460507a",      "app_id": "36e1b948-3a0a-4e71-80f3-625e61d6c832",      "attribute": {        "installation_id": "00000000-0000-0000-0000-000000000000",        "app_version": "0.8.0-SNAPSHOT.debug",        "app_build": "800",        "device_name": "emu64a",        "device_model": "sdk_gphone64_arm64",        "device_manufacturer": "Google",        "os_name": "android",        "os_version": "33"      },      "events": null,      "first_event_time": "2024-10-02T18:26:58.226Z",      "last_event_time": "2024-10-02T18:27:09.151Z",      "duration": 10925    }  ]}