Notice period and availability
Read preferences.availability. It tells you whether the candidate is
available immediately, after a notice period (as a number of days), or from a date, together with
the sentence it came from. If the CV doesn't say, source is absent and the
value is null, never a guess.
"availability": {
"value": { "status": "notice_period", "notice_days": 30, "available_from": null },
"source": "stated",
"confidence": 0.8,
"evidence": "Notice period: 1 month"
}
How the value is built
statusis one ofimmediate,notice_period,from_date,not_looking,unknown.notice_daysis calculated in code from the quoted phrase ("1 month", "three weeks", "90 days"), not estimated by a model.available_fromis never more precise than the CV: "Available from June 2027" becomes"2027-06", not an invented day.
Before acting on it
Notice periods change between writing a CV and applying. When confidence is low, the path appears
in agent_guidance.confirm_before_acting; an agent should confirm it with the candidate
before booking a start date.
Try it
Get a free API key (50 parses a month, no card), then:
curl https://api.verbatimcv.com/v1/parse \
-H "Authorization: Bearer $VERBATIMCV_API_KEY" \
-F file=@cv.pdf
Agents can use the parse_resume tool instead: uvx verbatimcv-mcp. See the
quickstart for Python, JavaScript and MCP setup.