This section documents public-facing admin analytics/member endpoints used by /admin/stats.Authentication#
Intended for organization admin/team manager analytics scope.
Internal-only API notice#
/api/admin/users endpoints are internal super-admin operations and are intentionally not exposed in public API docs.
Admin statistics endpoints (v1)#
Query: organization_id, team_id, start_date, end_date
GET /api/v1/admin/stats/users/{user_id} (member detail)Query: organization_id, team_id, start_date, end_date
GET /api/v1/admin/stats/progress/membersQuery: org_id, start_date, end_date, sort, order, page, limit, q
Common query parameters#
timezone: IANA timezone name, for example Asia/Jakarta. Accepted by the stats endpoints (dashboard, KPIs, targets, objectives, members, user detail, and exports). When omitted, the X-User-Timezone request header is used, and then the server default. Invalid names fall back to the default. It decides where day boundaries fall for date ranges and trend charts.
team_id: restricts results to one team. Supported by the dashboard, progress/kpi, progress/members, progress/objectives, and objective suggestions.
organization_id: also accepted by export/pdf.
comprehension_filter: additional filter for progress/members.
Response fields worth knowing#
GET /api/v1/admin/stats/ includes insights: an object with generated insight items for the selected scope.
Member rows (progress/members and the member directory) include analytics_available (boolean) and analytics_message. When analytics_available is false, the member's learning metrics are withheld, for example because Connect consent is missing, and analytics_message explains why. Treat the numeric fields as unavailable instead of zero.
progress/members also returns analytics_excluded_count: how many members were excluded from aggregates for that reason.
GET /api/v1/admin/stats/users/{user_id} returns the same analytics_available and analytics_message pair.
Objective and target responses include org_name (and org_id for targets).
Date range behavior#
API receives date-only values (YYYY-MM-DD).
Backend evaluates range in UTC day boundaries:start: 00:00:00Z inclusive
end: next day 00:00:00Z exclusive
Frontend /admin/stats now sends local calendar date strings to prevent timezone day-shift.
Member directory affiliations#
GET /api/v1/admin/stats/ member directory rows include:organizations: list of organization names
teams: list of team names
affiliations: normalized objects: This structure supports UI/PDF summaries and normalized CSV export behavior. Modified at 2026-10-13 16:06:44