SHshorebird
metrics

Distribution of currently-active devices by release version.

Returns the exact (non-HLL) count of currently-active devices for the app, grouped by release_version. "Currently active" is bounded by a server-side active-device window; rows with no reported release_version are returned with releaseVersion: null and represent devices on Flutter versions too old to emit the field. The result is sorted by deviceCount descending, then releaseVersion ascending with NULLs last.

get/apps/{appId}/metrics/version-distribution

Request

  • Base URL
    https://api.shorebird.dev/api/v1
  • Auth
    • HTTP bearer
    • or HTTP bearer

Response

The version distribution for the app.

total_devicesinteger required

Sum of device_count across all entries. Convenience for clients; matches the server-side sum used to compute percentage.

active_window_daysinteger required

The active-device window in days that bounds the query. Hardcoded server-side in v1; tier-gated per-caller windows land in a follow-up.

as_ofstring date-time required

Server's UTC timestamp at the moment the response was constructed. Not a freshness indicator for the underlying data, which is refreshed by an hourly scheduled query and may lag by up to ~1 hour.

Changes

No recorded changes to this operation across all 1 revision of this API.