Get analytics user stats

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Returns how many of the app's users are active, live, and inactive, for an at-a-glance dashboard.

A user counts once, in the bucket its most recent event falls into: active_users for the last 7 days, inactive_7d for 7 to 30 days ago, and inactive_30d for longer ago than that. Base44 keeps analytics events for 60 days, so inactive_30d covers 30 to 60 days and a user who has been away longer drops out of the counts entirely.

live_users is counted separately, from the app's heartbeats rather than its events, and covers the last 2 minutes.

Only users the app attributes its events to are counted. Events the app tracks without a user are not.

<Note>Each counter reports 0 when Base44 cannot read it, with a 200, so treat a sudden drop to zero as a possible read failure rather than a real one.</Note>

get/api/apps/{app_id}/analytics/stats/users

Path parameters

app_idstring required

ID of the app whose analytics to read.

ID of the app whose analytics to read.

Response

The app's user counts.

active_usersinteger

Users whose most recent event was in the last 7 days.

live_usersinteger

Users seen in the app in the last 2 minutes.

inactive_7dinteger

Users whose most recent event was between 7 and 30 days ago.

inactive_30dinteger

Users whose most recent event was more than 30 days ago.

Example response

{
  "active_users": 126,
  "live_users": 3,
  "inactive_7d": 88,
  "inactive_30d": 41
}

Changes