SHshorebird
metrics

Devices first seen within the active-device window.

Returns the count of the app's devices whose first recorded activity falls within the last window_days days — a device-growth signal — together with the count for the equal-length window immediately preceding it, which powers a period-over-period delta. Counts are exact (non-HLL). previous is null when the preceding window would begin before the metrics data floor, where a comparison against partially-recorded history would show a misleading delta.

get/apps/{appId}/metrics/new-devices

Request

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

Response

The new-device counts for the app.

currentinteger required

Devices first seen in the window [as_of − window_days, as_of). An exact (non-HLL) count.

previousinteger nullable required

Devices first seen in the equal-length window immediately preceding the current one, or null when that window would begin before the metrics data floor (comparing against partially-recorded history would show a misleading delta).

window_daysinteger required

The window length in days. Hardcoded server-side in v1; echoed so clients label the metric from the response rather than assuming a length.

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.