VerbatimCV

Quickstart

Send the CV as the form field file (PDF or DOCX, up to 10 MB and 20 pages), or a public https:// link as the form field url, to POST https://api.verbatimcv.com/v1/parse with your key in Authorization: Bearer <key>. You get back one JSON object in the VerbatimCV schema.

curl

curl https://api.verbatimcv.com/v1/parse \
  -H "Authorization: Bearer $VERBATIMCV_API_KEY" \
  -F file=@cv.pdf

# or a public link
curl https://api.verbatimcv.com/v1/parse \
  -H "Authorization: Bearer $VERBATIMCV_API_KEY" \
  -F url=https://example.com/cv.pdf

Python

import os
import requests

with open("cv.pdf", "rb") as f:
    r = requests.post(
        "https://api.verbatimcv.com/v1/parse",
        headers={"Authorization": f"Bearer {os.environ['VERBATIMCV_API_KEY']}"},
        files={"file": f},
        timeout=120,
    )
r.raise_for_status()
cv = r.json()

prefs = cv["preferences"]
if prefs["work_arrangement"]["source"] != "absent":
    print(prefs["work_arrangement"]["value"], "-", prefs["work_arrangement"]["evidence"])
print("Confirm first:", cv["agent_guidance"]["confirm_before_acting"])

JavaScript (Node 18+ or the browser)

import { readFile } from "node:fs/promises";

const form = new FormData();
form.append("file", new Blob([await readFile("cv.pdf")]), "cv.pdf");

const r = await fetch("https://api.verbatimcv.com/v1/parse", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.VERBATIMCV_API_KEY}` },
  body: form,
});
const cv = await r.json();
if (!r.ok) throw new Error(`${cv.error.code}: ${cv.error.message}`);

console.log(cv.candidate.full_name, cv.preferences.availability);

MCP (Claude Desktop and other agents)

Add this inside "mcpServers" in your Claude Desktop config (Settings → Developer → Edit Config), then restart:

"verbatimcv": {
  "command": "uvx",
  "args": ["verbatimcv-mcp"],
  "env": { "VERBATIMCV_API_KEY": "vcv_your_key_here" }
}

Your agent gets one tool, parse_resume, taking a local file_path or a public url.

Reading the result safely

Get a key

Get a free API key (50 parses a month, no card): enter your email and open the one-time link; the page shows the key once. Agents can start the same flow for their user:

curl https://api.verbatimcv.com/v1/signup \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com"}'

That returns 202 and emails the user a sign-in link; the key is never sent by email.