Holland-code career-interest scoring
Six vocational-interest dimensions — Realistic, Investigative, Artistic, Social, Enterprising, Conventional — scored server-side and returned as a Holland code. Three REST calls, X-API-Key auth, results attributed to your org.
JobCannon's RIASEC API exposes the Holland vocational-interest model as a live REST service. Two instruments are available: the full RIASEC battery (60 items, all six dimensions) and Career Match (12-item forced-choice, 2-minute completion) — both return { result_id, top_result, scores } where top_result is the dominant Holland code and scores contains all six R-I-A-S-E-C dimension values. Integration is three calls: POST /api/v1/assessments with { test: "riasec" } or { test: "career-match" } starts a session and returns the question set; GET /api/v1/assessments/{session_id}/questions re-fetches if needed; POST /api/v1/assessments/{session_id}/complete submits answers and returns the scored result. Authentication is a single X-API-Key header (jck_live_…, scopes assessments:send / assessments:read, SHA-256 hashed at rest). Scoring is deterministic, server-side, and identical to the consumer product. Results are attributed to the partner organisation via api_org_id. Typical adopters are career-guidance platforms, EdTech apps mapping users to programmes, university advising tools, and workforce-development case-management systems. Live on the Scale tier ($199/mo) with a monthly allotment then $2/assessment overage.
Holland-code scoring built for career and guidance products.
Both career-interest instruments share the same three-call lifecycle.
For career platforms, EdTech apps, and guidance tools
The RIASEC API is an instrument-specific entry point into the broader Assessment API — which covers the full three-call lifecycle, auth details, and all 126+ instruments. For the scientific framing of the Holland model alongside other psychometrics, see the psychometric API overview. The JobCannon for Business hub describes all institutional features.
If your platform also needs personality or EQ scoring alongside career interest, see the Big Five API, EQ API, and personality test API overview. Teams embedding the full experience under their own brand should review white-label theming.
Live on the Scale tier ($199/mo) with a monthly assessment allotment; additional assessments are $2 each. University and non-profit guidance partners should ask about partnership pricing. White-label EdTech resellers can move to a revenue-share.
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 whether you need the full RIASEC battery, Career Match, or both — and your expected monthly volume. We respond with a key, the endpoint reference, and a technical onboarding plan.
RIASEC — Realistic, Investigative, Artistic, Social, Enterprising, Conventional — is John Holland's vocational-interest model, the most widely used career-guidance framework in counselling and EdTech. A RIASEC profile tells you which types of work environments and activities a person is naturally drawn to, making it the standard anchor for career-match features, advising software, and guidance-counsellor workflows. The JobCannon RIASEC and Career Match instruments both return Holland codes, so your platform can map a user's top code against occupation databases or your own programme catalogue.
POST /api/v1/assessments/{session_id}/complete returns { result_id, test, top_result, scores, question_pool }. For the RIASEC instrument, top_result is the dominant Holland code (e.g. "ISA") and scores contains all six dimension values (R, I, A, S, E, C) as normalised scores. For Career Match (the 12-item forced-choice mini version), top_result is the single strongest Holland type. Both instruments return the same response shape, so a single rendering layer can handle both.
RIASEC is the full 60-item instrument covering all six dimensions in depth — suited to formal guidance contexts and research. Career Match is a 12-item forced-choice version designed for quick consumer flows (2-minute completion). Both return a Holland-code top_result. Pass "riasec" or "career-match" as the test slug in POST /api/v1/assessments to choose which you administer.
POST /api/v1/assessments with { test: "riasec", locale?, external_user_id? } starts a session and returns the full question set. GET /api/v1/assessments/{session_id}/questions re-serves those questions if you need them again (scope assessments:read). POST /api/v1/assessments/{session_id}/complete with { answers: number[] } submits the answer vector, scores it server-side, and returns the result. Scoring runs on the same engine as jobcannon.io — identical to a consumer-side assessment.
Yes. The API returns the Holland code; you map it to whatever catalogue makes sense for your platform — occupation databases, university programmes, apprenticeship tracks, or your own content. The richer AI Career Guide narrative (2,536-career mapping) is a separate surface scoped per partner, not a default v1 response.
One X-API-Key header per request. Keys are issued per organisation (format jck_live_…), scoped to assessments:send and assessments:read, and SHA-256 hashed at rest. No OAuth exchange. Sessions are short-lived signed tokens returned by the start call, so you hold no session state on your side.
The API is live on the Scale tier ($199/mo), which includes a monthly assessment allotment. Assessments over the cap are $2 each. University and non-profit guidance platforms should ask about partnership pricing. White-label EdTech resellers can move to a revenue-share.