Access personality assessment results and trait analysis.
The Personality Tests API provides access to personality assessment results based on the Big Five model. Use it to understand candidate traits and cultural fit.
/personality-tests| Name | Type | Required | Description |
|---|---|---|---|
| candidate_id | string | Optional | Filter by candidate ID |
| completed_after | string | Optional | Filter by completion date (ISO 8601) |
{
"data": [
{
"id": "pers_stu901",
"candidate_id": "cand_xyz789",
"completed_at": "2024-02-11T10:30:00Z",
"traits": {
"openness": 82,
"conscientiousness": 78,
"extraversion": 65,
"agreeableness": 72,
"neuroticism": 34
},
"summary": "High in openness and conscientiousness, moderate extraversion..."
}
],
"pagination": { "total": 67, "limit": 20, "has_more": true }
}/personality-tests/{test_id}{
"id": "pers_stu901",
"candidate_id": "cand_xyz789",
"completed_at": "2024-02-11T10:30:00Z",
"traits": {
"openness": { "score": 82, "percentile": 88, "description": "Highly creative and open to new experiences" },
"conscientiousness": { "score": 78, "percentile": 75, "description": "Well-organized and reliable" },
"extraversion": { "score": 65, "percentile": 62, "description": "Moderately social and outgoing" },
"agreeableness": { "score": 72, "percentile": 68, "description": "Cooperative and empathetic" },
"neuroticism": { "score": 34, "percentile": 30, "description": "Emotionally stable and resilient" }
},
"work_style": {
"teamwork": "High - works well in collaborative environments",
"leadership": "Moderate - comfortable leading when needed",
"independence": "High - self-directed and autonomous",
"stress_management": "High - remains calm under pressure"
},
"cultural_fit_scores": [
{ "culture_type": "innovative", "fit_score": 88 },
{ "culture_type": "structured", "fit_score": 75 },
{ "culture_type": "collaborative", "fit_score": 70 }
]
}/personality-tests/compare| Name | Type | Required | Description |
|---|---|---|---|
| test_ids | array | Required | Array of test IDs to compare (max 5) |
Personality assessments complement technical skills but should not be the sole hiring criteria. Use them to understand work style preferences and team dynamics.
Was this article helpful?