Coordinator Stats Service

Get aggregated stats summary for a coordinator for a given period

{
  "coordinator_id": "coord_4f8a21",
  "coordinator_name": "Maria Chen",
  "org_id": "org_university_west",
  "period": "last_30_days",
  "start_date": "2026-02-24",
  "end_date": "2026-03-25",
  "total_peer_mentors": 14,
  "active_peer_mentors": 11,
  "total_activities": 87,
  "completed_activities": 79,
  "completion_rate": 0.908,
  "avg_activities_per_mentor": 6.21,
  "avg_session_duration_minutes": 48,
  "new_mentors_this_period": 2,
  "top_activity_type": "one_on_one_session"
}

Get per-mentor stats for all peer mentors under this coordinator

{
  "data": [
    {
      "mentor_id": "mentor_b2c91a",
      "mentor_name": "James Park",
      "total_activities": 12,
      "completed_activities": 11,
      "completion_rate": 0.917,
      "last_activity_date": "2026-03-22",
      "avg_session_duration_minutes": 52,
      "engagement_score": 87,
      "status": "active"
    },
    {
      "mentor_id": "mentor_d7f33c",
      "mentor_name": "Aisha Mohammed",
      "total_activities": 9,
      "completed_activities": 9,
      "completion_rate": 1,
      "last_activity_date": "2026-03-24",
      "avg_session_duration_minutes": 45,
      "engagement_score": 94,
      "status": "active"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 14
  }
}

Get activity volume broken down by activity type for this coordinator's mentors

{
  "data": [
    {
      "activity_type_id": "act_type_001",
      "activity_type_name": "One-on-One Session",
      "count": 41,
      "percentage": 47.1,
      "avg_duration_minutes": 52,
      "completed_count": 39
    },
    {
      "activity_type_id": "act_type_002",
      "activity_type_name": "Group Workshop",
      "count": 23,
      "percentage": 26.4,
      "avg_duration_minutes": 75,
      "completed_count": 20
    },
    {
      "activity_type_id": "act_type_003",
      "activity_type_name": "Check-in",
      "count": 23,
      "percentage": 26.4,
      "avg_duration_minutes": 18,
      "completed_count": 20
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 3
  }
}

Get monthly activity counts over a date range for trend charts

{
  "data": [
    {
      "year": 2025,
      "month": 10,
      "month_label": "Oct 2025",
      "total_activities": 61,
      "completed_activities": 56,
      "active_mentors": 10,
      "new_mentors": 1
    },
    {
      "year": 2025,
      "month": 11,
      "month_label": "Nov 2025",
      "total_activities": 74,
      "completed_activities": 70,
      "active_mentors": 11,
      "new_mentors": 0
    },
    {
      "year": 2025,
      "month": 12,
      "month_label": "Dec 2025",
      "total_activities": 52,
      "completed_activities": 48,
      "active_mentors": 10,
      "new_mentors": 0
    },
    {
      "year": 2026,
      "month": 1,
      "month_label": "Jan 2026",
      "total_activities": 80,
      "completed_activities": 76,
      "active_mentors": 12,
      "new_mentors": 2
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 4
  }
}

{
  "contract_summary": {
    "total_contracts": 410,
    "total_endpoints": 2416,
    "api_styles_used": [
      "rest"
    ]
  },
  "generated_at": "2026-03-26T06:55:53.316Z"
}