LiyaEngine Docs

Career Assessment

Assess a candidate's career readiness, trajectory, and market positioning based on their profile.

Dashboard

POST /v1/hiring/career-assessment

Evaluates career readiness across profile completeness, skill relevance, experience depth, and market demand. Returns a readiness score, trajectory analysis, and recommended next steps.


Required inputs

FieldTypeNotes
input.user_idstringYour platform's user ID
input.profileProfileInputStructured professional profile

Optional inputs

FieldTypeNotes
input.resumeResumeInputResume text to supplement profile data
input.career_goalsCareerGoalsInputAligns assessment to stated career direction

Example request

curl -X POST https://api.liyaengine.ai/v1/hiring/career-assessment \
  -H "Authorization: Bearer $LIYA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": {
      "user_id": "usr_123",
      "profile": {
        "title": "Mid-level Product Manager",
        "years_of_experience": 4,
        "experience_level": "mid",
        "skills": ["product roadmap", "Jira", "user research", "SQL"],
        "work_experiences": [ ... ],
        "educations": [ ... ]
      },
      "career_goals": {
        "target_role": "Senior Product Manager",
        "timeline": "6_months"
      }
    }
  }'

Response

{
  "success": true,
  "data": {
    "output": {
      "readiness": {
        "overall_score": 71,
        "confidence": { "score": 0.86, "level": "high" },
        "components": [
          { "name": "Profile Completeness", "score": 85, "weight": 0.2, "feedback": "Work history and skills are well documented." },
          { "name": "Skill Relevance", "score": 68, "weight": 0.25, "feedback": "Core PM skills present; data analysis depth is limited." }
        ],
        "interpretation": {
          "level": "competitive",
          "summary": "On track for a senior IC role within 6–12 months with targeted skill development.",
          "market_position": "Above average for mid-level PMs, below typical senior-PM bar on data depth."
        }
      },
      "career_phase": {
        "current_phase": "Mid-Career Growth",
        "characteristics": ["Building specialization", "Seeking scope expansion"],
        "typical_challenges": ["Limited 0-to-1 ownership", "Thin external portfolio"]
      },
      "strengths": [
        { "strength": "Strong stakeholder management experience", "evidence": "Led cross-functional roadmap reviews across 3 teams", "how_to_leverage": "Highlight in senior PM interviews as leadership evidence" },
        { "strength": "SQL proficiency differentiates from typical PMs", "evidence": "Independently built reporting dashboards", "how_to_leverage": "Pair with a data-driven case study" }
      ],
      "gaps": [
        { "gap": "Limited evidence of driving 0-to-1 product launches", "impact": "Weakens candidacy for senior PM roles that expect launch ownership", "recommendation": "Seek or document a 0-to-1 initiative" },
        { "gap": "No public-facing portfolio or case studies", "impact": "Harder to differentiate externally", "recommendation": "Publish a written case study" }
      ],
      "market_position": {
        "competitiveness": "above_average",
        "differentiators": ["SQL proficiency", "Cross-functional stakeholder management"],
        "areas_for_differentiation": ["0-to-1 ownership", "Public portfolio"]
      },
      "recommendations": {
        "headline": "Close the 0-to-1 gap before pursuing senior roles",
        "summary": "Strong foundation with a clear, addressable gap in product-launch ownership.",
        "immediate_actions": ["Document a product case study with outcome metrics", "Build data analysis skills beyond SQL (Python/analytics tools)"],
        "long_term_strategy": "Target a team with 0-to-1 scope in the next role to close the launch-ownership gap."
      },
      "actions": [
        { "action_id": "career_path_planning", "action_type": "primary", "title": "See career path", "priority": 1 },
        { "action_id": "skill_gap_analysis", "action_type": "secondary", "title": "View skill gaps", "priority": 2 }
      ],
      "confidence": { "score": 0.86, "level": "high" }
    }
  }
}

On this page