Type + trait results as an API
Big Five, DISC, HEXACO, Enneagram, conflict-styles — 126+ personality instruments behind three REST calls. X-API-Key auth, type and dimension scores attributed to your org, user never leaves your domain.
JobCannon's personality test API exposes validated personality instruments — Big Five (OCEAN), DISC, HEXACO, Enneagram, conflict-styles, and more — as a programmable REST service. Integration follows the same three-call lifecycle as the broader assessment API: POST /api/v1/assessments starts a session with the chosen instrument and returns the question set; GET /api/v1/assessments/{session_id}/questions re-serves those questions; POST /api/v1/assessments/{session_id}/complete submits answers and returns { result_id, top_result, scores, question_pool }. Authentication is a single X-API-Key header (format jck_live_…, scopes assessments:send and assessments:read, SHA-256 hashed at rest) — no OAuth exchange. Scoring is deterministic and server-side, with directional-item handling and degenerate-submission rejection. Every result is attributed to the partner organisation via api_org_id. Typical use cases include personality-type cards inside dating and social apps, team-fit and culture-add indicators inside hiring tools, and self-discovery widgets inside coaching and HR-tech products. Live on the Scale tier ($199/mo) with a monthly allotment then $2/assessment overage; white-label resale partners can move to revenue-share.
Breadth of instruments, depth of scores — ready to embed.
Pass the instrument slug to POST /api/v1/assessments and the question set comes back.
For products embedding a personality instrument
The personality test API is a focused view of the broader psychometric API — which also covers vocational-interest, cognitive, and values instruments — and the full Assessment API reference with the three-call lifecycle and auth details. For instrument-specific pages, see the Big Five API and EQ API.
All institutional features are described on the JobCannon for Business hub. Teams who want their brand on the assessment experience should pair this with white-label theming. For the RIASEC career-orientation instrument, see the RIASEC API page.
The personality test API is live on the Scale tier ($199/mo), which includes a monthly assessment allotment; additional assessments are $2 each. White-label partners who embed and resell personality results can move to a revenue-share instead.
Always free for micro-teams
For solo coaches and small HR
For startups, teams and HR
For agencies, L&D and scale-ups
For 200+ person companies
Self-serve checkout via Stripe — major cards, Apple Pay, Google Pay, Link. Cancel anytime; 14-day money-back on Starter, Team, and Scale. Enterprise via the contact form below.
Tell us which personality instruments you need and your expected monthly volume. We respond with an API key, the endpoint reference, and a technical onboarding plan.
The API exposes validated personality instruments across trait and type traditions: Big Five (Five-Factor Model, five OCEAN dimension scores), DISC (four workplace-behaviour quadrants), HEXACO (six-factor model including Honesty-Humility), Enneagram (nine-type typology), and conflict-styles (five Thomas-Kilmann modes). These are part of a broader library of 126+ instruments. Each instrument returns a top_result (the dominant type, code, or profile label) and full per-dimension scores you render however your product needs.
POST /api/v1/assessments/{session_id}/complete returns { result_id, test, top_result, scores, question_pool }. For a Big Five call, scores contains all five OCEAN dimensions as normalised values. For DISC, top_result is the dominant quadrant (D, I, S, or C) and scores contain all four. For Enneagram, top_result is the dominant type number. The structure is consistent — your rendering layer always reads top_result for the headline and scores for the breakdown.
Yes — this is a common use case. The user never leaves your domain: you render the question set returned by POST /api/v1/assessments, collect answers in your own UI, and POST them to the complete endpoint. The result is attributed to your organisation via api_org_id, not to a JobCannon consumer account. You own the data and decide how to display the type card, match score, or team map inside your product.
Every request carries a single X-API-Key header. Keys are issued per organisation (format jck_live_…), scoped to assessments:send (start + complete) and assessments:read (re-fetch questions), and SHA-256 hashed at rest. There is no OAuth exchange. Sessions are short-lived signed tokens returned by the start call — no session store to maintain on your side.
Scoring is deterministic and server-side. Your client submits answer indices; the scoring engine holds the key. Directional (socially-desirable or fake-good) item handling is built into the engine. Degenerate submissions — where an untouched default-answer vector would produce a meaningful result — are rejected before a result row is written. This is the same integrity layer protecting consumer-side assessments.
The personality test API is live on the Scale tier ($199/mo), which includes a monthly assessment allotment. Assessments over the cap are $2 each. Partners who white-label and resell personality results inside their own product can move to a revenue-share model instead of per-assessment billing.