Fetch sessions with high memory usage

GET/apps/{id}/memory/sessions/highUsage

Returns sessions with at least one sample close to the app's memory limit, highest usage first.

On Android, a sample qualifies when it reaches 75% of its memory target. The target depends on the device's RAM and the sample's app importance. peak_memory_kb, target_memory_kb and percent_of_target describe the sample with the highest percentage of its target. Sessions are ordered by percent_of_target.
On iOS and iPadOS, a sample qualifies when it uses 75% or more of the memory available to the app, used_memory / (used_memory + available_memory). Samples without available memory are ignored. Sessions are ordered by peak_memory_limit_utilization.
Values are in KB (1024 bytes). Android reports anonymous RSS plus swap, and iOS and iPadOS report used memory.
Filter by app state with app_state:eq:<value>. It applies to Android samples only. Without it, samples of every app state are included.

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.

limit?integer

Maximum sessions to return. The dashboard requests 5.

Range1 <= value <= 1000

Default10

offset?integer

Number of sessions to skip.

Range0 <= value

Default0

Response Body

`application/json`

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

{  "results": [    {      "session_id": "8d5a6d39-4c76-43d3-aecd-650e2c36f9c2",      "app_id": "2b7ddad4-40a6-42a7-9e21-a90577e08263",      "first_event_time": "2026-09-10T10:00:00Z",      "last_event_time": "2026-09-10T10:05:00Z",      "peak_memory_kb": 3145728,      "target_memory_kb": 2359296,      "percent_of_target": 133.33333333333334,      "attribute": {        "app_version": "1.2.3",        "app_build": "42",        "device_name": "Pixel",        "device_model": "Pixel",        "device_manufacturer": "Google",        "device_total_memory": 6291456,        "os_name": "android",        "os_version": "15"      }    }  ],  "meta": {    "next": false,    "previous": false  }}