Fetch an app's health metrics

GET/apps/{id}/metrics

Fetch an app's health metrics. Filter time range using from & to query string parameters. Filter version using versions & version_codes query string parameters.

Both versions & version_codes should be present if any one of them is present, and the number of items in each must be the same. 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 not selected by the version filters, for comparison against the selected versions.

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.

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.

versions?string

Comma separated version identifiers.

version_codes?string

Comma separated version codes.

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  },  "warm_launch": {    "p95": 407,    "unselected_p95": 415,    "no_data": false,    "unselected_no_data": false  }}