Admin Stats and Members

This section documents public-facing admin analytics/member endpoints used by /admin/stats.

Authentication

Bearer token required.

Intended for organization admin/team manager analytics scope.

/api/admin/users endpoints are internal super-admin operations and are intentionally not exposed in public API docs.

GET /api/v1/admin/stats/

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/members

Query: org_id, start_date, end_date, sort, order, page, limit, q

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.

GET /api/v1/admin/stats/ member directory rows include:

organizations: list of organization names

teams: list of team names

affiliations: normalized objects:

organization_id

organization_name

team_id

team_name

This structure supports UI/PDF summaries and normalized CSV export behavior.