API & MCP

Build smarter hiring with one API

Collega workflow di assessment, voce, CV, webhook e agenti IA governati tramite endpoint REST e strumenti MCP documentati.

REST + JSON

OpenAPI 3.0 spec

Controlli di governance IA

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

Superficie API documentata

Webhooks

Consegna di eventi firmati

119

Opzioni nel catalogo connettori

MCP

Accesso governato per agenti IA

What's in the API

One platform, one API key

Usa capacità documentate per assessment, CV, colloqui, webhook e MCP con una sola chiave API.

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

Usa il catalogo fornitori per configurare scambi di candidati, risultati e workflow per le connessioni cliente supportate.

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

L'API supporta scoring, metadati informativi, report multilingue, PDF e controlli di audit. Gli obblighi del cliente restano specifici per l'uso.

JSON over HTTPS

OpenAPI 3.0 spec

Webhook events

HMAC-SHA256 signatures

Sandbox environment

Controlli di audit e supervisione umana

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.