Certification Status Service

List derived certification statuses for all mentors in an org

{
  "data": [
    {
      "mentor_id": "mentor_a1b2c3",
      "status": "active",
      "is_suppressed_from_public": false,
      "days_until_expiry": 234,
      "is_within_warning_window": false
    },
    {
      "mentor_id": "mentor_d4e5f6",
      "status": "warning",
      "is_suppressed_from_public": false,
      "days_until_expiry": 15,
      "is_within_warning_window": true
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 48
  }
}

Get derived certification status for a specific mentor

{
  "mentor_id": "mentor_a1b2c3",
  "status": "active",
  "is_suppressed_from_public": false,
  "expiry_date": "2028-01-20T00:00:00Z",
  "days_until_expiry": 665,
  "is_within_warning_window": false,
  "warning_threshold_days": 30
}

Derive status from supplied expiry date and paused flag (stateless computation)

{
  "expiry_date": "2026-04-10T00:00:00Z",
  "is_paused": false,
  "is_hlf": false,
  "threshold_days": 30
}

{
  "status": "warning",
  "days_until_expiry": 15,
  "is_within_warning_window": true,
  "is_suppressed_from_public": false
}

Recompute and persist derived status for a mentor

{
  "force_recompute": true
}

{
  "mentor_id": "mentor_a1b2c3",
  "previous_status": "warning",
  "new_status": "active",
  "recomputed_at": "2026-03-26T10:00:00Z"
}

Clear cached derived status (forces recompute on next fetch)

{
  "cleared": true,
  "mentor_id": "mentor_a1b2c3"
}

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