Fetch an app's health metrics

GET/apps/{id}/metrics

Fetch an app's health metrics, optionally narrowed by a filter expression over the app version. from & to values must be ISO 8601 UTC strings in milliseconds precision and default to a last 7 days time range if not supplied.

Each session and launch metric also carries an unselected_ variant holding the same metric computed over the app versions the filter expression leaves out, for comparison against the selected versions. Without a filter expression every version is selected, so the unselected side has no data and adoption is 100%.

no_data and unselected_no_data are true when there was no data to compute the metric, for example no sessions on that side. The metric value is then a placeholder zero.

sizes is null unless the filter expression selects a single app version name, since a download size belongs to a single build. A version with several builds in the range reports its most recently seen build.

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.

Response Body

`application/json`

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

{  "adoption": {    "all_versions": 53,    "selected_version": 23,    "adoption": 43.4,    "no_data": false  },  "anr_free_sessions": {    "anr_free_sessions": 99.4,    "unselected_anr_free_sessions": 99.1,    "no_data": false,    "unselected_no_data": false  },  "cold_launch": {    "p95": 923,    "unselected_p95": 940,    "no_data": false,    "unselected_no_data": false  },  "crash_free_sessions": {    "crash_free_sessions": 98.2,    "unselected_crash_free_sessions": 98.6,    "no_data": false,    "unselected_no_data": false  },  "hot_launch": {    "p95": 152,    "unselected_p95": 160,    "no_data": false,    "unselected_no_data": false  },  "perceived_anr_free_sessions": {    "perceived_anr_free_sessions": 99.6,    "unselected_perceived_anr_free_sessions": 99.3,    "no_data": false,    "unselected_no_data": false  },  "perceived_crash_free_sessions": {    "perceived_crash_free_sessions": 98.5,    "unselected_perceived_crash_free_sessions": 98.9,    "no_data": false,    "unselected_no_data": false  },  "sizes": {    "average_app_size": 26298701,    "selected_app_size": 25887094,    "delta": -411607,    "no_data": false,    "multiple_versions": false  },  "warm_launch": {    "p95": 407,    "unselected_p95": 415,    "no_data": false,    "unselected_no_data": false  }}