API & MCP

Build smarter hiring with one API

Connect assessment, voice, CV, webhook, and governed AI-agent workflows through documented REST endpoints and MCP tools.

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"

}

REST

Documented API surface

Webhooks

Signed event delivery

119

Connector catalog options

MCP

Governed AI-agent access

What's in the API

One platform, one API key

Use documented assessment, CV, interview, webhook, and MCP capabilities through one API key.

Assessment API

Trigger psychometric assessments programmatically, manage campaigns, retrieve scored results, recorded-evidence explanations, and localized 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, verified norm indicators when available, localized narratives, PDF URLs, and webhook events, 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.