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 "x-api-key: $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_score": 71,
"profile_completeness_score": 85,
"skill_relevance_score": 68,
"experience_depth_score": 73,
"market_demand_score": 80,
"presentation_score": 64,
"confidence": { "score": 0.86, "level": "high" },
"trajectory": "On track for senior IC role within 6–12 months with targeted skill development",
"strengths": [
"Strong stakeholder management experience",
"SQL proficiency differentiates from typical PMs"
],
"development_areas": [
"Limited evidence of driving 0-to-1 product launches",
"No public-facing portfolio or case studies"
],
"recommended_actions": [
"Document a product case study with outcome metrics",
"Build data analysis skills beyond SQL (Python/analytics tools)"
],
"actions": [
{ "id": "career_path_planning", "label": "See career path", "primary": true },
{ "id": "skill_gap_analysis", "label": "View skill gaps", "primary": false }
]
}
}
}