API & MCP

Build smarter hiring with one API

Psychometric workflows, voice interviews, CV analysis, and AI services through REST endpoints with disclosure, audit, and oversight controls. Legal conformity is deployment-specific.

REST + JSON

OpenAPI 3.0 spec

AI governance controls

Read the docs Get API key

POST /v1/assessments/sessions

# Start a psychometric assessment

curl -X POST \

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

-H "Authorization: Bearer $API_KEY" \

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

-d '{

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

"candidateEmail": "[email protected]",

"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

Use the provider catalog to configure candidate, result, and workflow exchange for supported customer connections.

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 /v1/assessments/sessions/:id/result

{

"sessionId": "sess_clx7m2...",

"overallScore": 73,

"overallPercentile": 81,

"jobFitScore": 88,

"jobFitClassification": "Excellent Fit",

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

"reportPdfUrl": "https://api.jobinterview.live/v1/assessments/sessions/{sessionId}/report",

"humanOversightRequired": true

}

Simple by design

Start an assessment in one call

The API supports scoring, disclosure metadata, multilingual reports, PDF generation, and audit controls. Customer obligations remain deployment-specific.

JSON over HTTPS

OpenAPI 3.0 spec

Webhook events

HMAC-SHA256 signatures

Sandbox environment

Audit and human-oversight controls

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.