Assessment API for university career services
Students self-serve RIASEC, Big Five, Values, Skills Audit and more inside your existing platform. Per-student external_user_id, 18-locale question delivery, advisor result access — 126+ instruments, three REST calls.
The JobCannon Assessment API gives university career services and student portals a validated career assessment layer inside their existing infrastructure — no separate student portal, no third-party login, no results stranded in a vendor dashboard. Integration is three REST calls: POST /api/v1/assessments starts a session with the chosen instrument slug, locale, and the student's external_user_id (your student record ID); GET /api/v1/assessments/{session_id}/questions re-serves the question payload for in-progress sessions; POST /api/v1/assessments/{session_id}/complete submits the student's answers, scores them server-side, and returns { result_id, test, top_result, scores, question_pool }. Authentication is a single X-API-Key header (format jck_live_…, scopes assessments:send / assessments:read, SHA-256 hashed at rest) — no OAuth. Students complete the assessment inside your portal using your own UI; the question payload is JSON you render with your own components. Results persist to your institution via api_org_id, attributed by the external_user_id you supply, and are immediately available to advisors in whichever system you surface them. Localisation is first-class: 18 live locales, inferred or selectable at session start. Core career-services instruments: RIASEC (vocational interest), Career Match (fast 2-minute RIASEC mini), Big Five (personality baseline), Values (motivational drivers), Skills Audit (graduate employability competencies). Cohort-scale delivery supported; rate limiting is per key with HTTP 429 + resetAt. Available on the Scale tier ($199/mo) with a monthly assessment allotment then $2/assessment overage.
Assessment inside your student portal, results inside your advising workflow.
Start a session with any instrument slug — whitelist the instruments your advising team uses.
For adding assessment inside a university student portal
The university integration uses the same three-call lifecycle as the full Assessment API. For multi-language delivery detail — locale codes, right-to-left rendering, and coverage list — see the multi-language assessment page. For a complete view of the psychometric frameworks available, see the psychometric API overview.
Building for a different platform? See the API for LMS & EdTech, ATS & recruiting, and coaching platforms. All integrations are on the JobCannon for Business hub.
The embed API is live on the Scale tier ($199/mo), which includes a monthly assessment allotment; additional assessments are $2 each. Institutions with large cohorts and first-destination or advising reporting requirements can move to partnership pricing. Dedicated technical onboarding and custom data residency scoped under partnership.
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 your student portal, the instruments your career services team needs, your cohort size, and the locales you serve. We respond with a key, the endpoint reference, and a technical onboarding plan.
Five instruments cover the majority of career-advising workflows. RIASEC (Holland codes) is the standard vocational-interest instrument and the most-used assessment in first-destination and advising contexts. Career Match (mini RIASEC, 12 forced-choice questions, 2-minute completion) gives a fast interest signal for student onboarding or mass-delivery contexts. Big Five provides a personality baseline for advisors discussing strengths and development. Values (Schwartz framework) surfaces motivational drivers that help advisors link student interests to career direction. Skills Audit maps self-assessed competency against 21st-century skill clusters for graduate employability reporting.
Pass the student's university ID as external_user_id in the POST /api/v1/assessments body. The same value passes through to POST /api/v1/assessments/{session_id}/complete, and the result row written to your org via api_org_id carries it. The complete call returns { result_id, top_result, scores } — you store those against the student record and surface them in your advising system, CRM, or reporting dashboard. Advisors see the result inside your existing tools. Students never need to leave your portal or create a jobcannon.io account.
Yes. Each student session is independent — one POST /api/v1/assessments per student, one POST /api/v1/assessments/{session_id}/complete per student. Rate limiting is per API key with HTTP 429 + resetAt, so there is no silent throttling and no dropped submissions during peak periods like orientation week or graduation-season advising surges. For planned whole-cohort rollouts, share your expected peak volume and timing with us and we configure per-key limits to match.
Yes. Pass a locale parameter in the POST /api/v1/assessments body and the full question set — text, options, and result labels — returns in that language. JobCannon has 18 live locales including Spanish, French, Arabic, German, Japanese, Korean, Portuguese, Chinese (Simplified), Hindi, Russian, Italian, Indonesian, Swedish, Polish, Dutch, Ukrainian, and Hebrew. Your portal can infer locale from the student profile or present a language selector at session start. Scoring is identical across all locales; only the surface text changes.
Student assessments are attributed to your institution via api_org_id — the result is your data record, not a jobcannon.io consumer profile. The external_user_id (your student ID) is the only link between the result and the individual; JobCannon does not store personally identifiable information against that field unless you embed it. API keys are SHA-256 hashed at rest, scoped to specific operations, and revocable. Session tokens are short-lived and signed — there is no persistent session that persists after the assessment is complete.
Dedicated career-platform licences — Handshake Premium, Symplicity, Careers in Universities-class — bundle the assessment capability with the advising workflow in a single platform, but require the student to use a separate portal and mean assessment results live outside your existing student information system. The JobCannon API embeds the assessment inside whatever student portal you already run. It is live on the Scale tier ($199/mo) with a monthly assessment allotment; additional assessments are $2 each. You get 126+ validated instruments, 18-locale question delivery, and results in your own records on day one.