Career Assessment
Assess a candidate's career readiness, trajectory, and market positioning based on their profile.
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
| Field | Type | Notes |
|---|---|---|
input.user_id | string | Your platform's user ID |
input.profile | ProfileInput | Structured professional profile |
Optional inputs
| Field | Type | Notes |
|---|---|---|
input.resume | ResumeInput | Resume text to supplement profile data |
input.career_goals | CareerGoalsInput | Aligns 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" }
}
}
}