Career Overview

Get full career intelligence analysis based on user’s learned skills.

Returns safe defaults when ROLES catalog is empty: role_fits=[], best_fit_pct=0.0.

GET /api/career/overview

Career Overview

cURL

curl --request GET \
  --url https://api.example.com/api/career/overview

200

{
  "best_fit_level": "junior",
  "best_fit_pct": 50,
  "best_fit_role": "<string>",
  "recommended_next_skills": [
    "<string>"
  ],
  "role_fits": [
    {
      "coverage_pct": 50,
      "covered_skills": [
        "<string>"
      ],
      "level": "junior",
      "missing_preferred": [
        "<string>"
      ],
      "missing_required": [
        "<string>"
      ],
      "preferred_covered": 1,
      "preferred_total": 1,
      "required_covered": 1,
      "required_total": 1,
      "role_slug": "<string>",
      "role_title": "<string>",
      "salary_high": 1,
      "salary_low": 1,
      "salary_mid": 1,
      "market_alignment_pct": 0
    }
  ],
  "user_skill_count": 1,
  "user_skills": [
    "<string>"
  ],
  "linkedin_imported_at": "<string>",
  "linkedin_skills": [
    "<string>"
  ]
}

Response

200 - application/json

Successful Response

Full career intelligence analysis.

best_fit_level · enum<string> · required

Available options: junior, mid, senior, staff

best_fit_pct · number · required

Required range: 0 <= x <= 100

best_fit_role · string · required

recommended_next_skills · string[] · required

role_fits · RoleFit · object[] · required

Show child attributes

user_skill_count · integer · required

Required range: x >= 0

user_skills · string[] · required

linkedin_imported_at · string | null

linkedin_skills · string[]