API & MCP

Build smarter hiring with one API

Psychometric assessments, voice interviews, CV analysis, and multi-agent AI — all accessible via clean REST endpoints. EU AI Act compliant by default.

REST + JSON

OpenAPI 3.0 spec

EU AI Act compliant

Read the docs Get API key

POST /api/assessments/sessions

# Start a psychometric assessment

curl -X POST \

https://jobinterview.live/api/assessments/sessions \

-H "Authorization: Bearer $API_KEY" \

-H "Content-Type: application/json" \

-d '{

"definitionId": "cognitive-battery-v2",

"candidateEmail": "alice@acme.com",

"locale": "fr"

# Response201 Created

{

"sessionId": "sess_clx7m2...",

"inviteUrl": "https://jobinterview.live/...",

"status": "INVITED"

}

260+

API endpoints

Data models

ATS integrations

Native languages

What's in the API

One platform, one API key

Every capability available in the Jobinterview dashboard is also available as an API. Build what you need.

Assessment API

Trigger psychometric assessments programmatically, manage campaigns, retrieve scored results, SHAP explanations, and PDF reports.

Voice Interview API

Start AI-powered voice interviews, stream transcripts, retrieve STAR analysis and competency scores per session.

CV Parsing API

Upload a CV and get back 100+ structured fields — education, experience, skills, languages — in milliseconds.

AI Agents API

Integrate the AI coaching assistant, copilot, and Board Room multi-agent orchestrator into your own product.

ATS Integration API

Sync candidates, push assessment results, and trigger workflows across 34 ATS systems via Unified.to.

MCP Server

Claude, GPT-4o, and any MCP-compatible agent can call Jobinterview tools natively — no glue code needed.

Full API reference

Getting started

Up and running in minutes

Generate your API key

Create an account or log in to your dashboard. Your API key is available immediately under Settings.

Call any endpoint

Standard REST over HTTPS. JSON in, structured data out. The full OpenAPI 3.0 spec is available at docs.jobinterview.live.

Receive structured results

Scores, percentiles, narratives, PDF URLs, webhook events — everything your product needs, ready to consume.

GET /api/assessments/sessions/:id/result

{

"sessionId": "sess_clx7m2...",

"overallScore": 73,

"overallPercentile": 81,

"jobFitScore": 88,

"jobFitClassification": "Excellent Fit",

"narrative_fr": "Alice presente...",

"reportPdfUrl": "https://blob.vercel-storage...",

"humanOversightRequired": true

}

Simple by design

Start an assessment in one call

The API handles scoring, EU AI Act compliance, multilingual reports, and PDF generation automatically.

JSON over HTTPS

OpenAPI 3.0 spec

Webhook events

HMAC-SHA256 signatures

Sandbox environment

EU AI Act compliant

Read the docs

AI Agents

Native MCP server

Let Claude, GPT-4o, or any MCP-compatible AI agent call Jobinterview tools directly. Start assessments, retrieve results, parse CVs — from within any AI workflow, without writing API adapters.

Works with Claude, GPT-4o, Gemini
Exposes 20+ tools natively
No glue code or adapters
Full docs at docs.jobinterview.live

MCP documentation

Claude — MCP tool use

// Claude can call these tools natively

use_mcp_tool(

server_name: "jobinterview",

tool_name: "start_assessment",

arguments: { candidateEmail, definitionId }

)

start_assessment

get_result

parse_cv

list_campaigns

invite_candidate

+15 more tools

Ready to build?

Full API reference, guides, code examples, and MCP documentation at docs.jobinterview.live.