Candidate evaluation API for engineering hiring workflows.
Add Recruo's AI technical interview, secure browser validation, AI-skills signals, and structured scorecards to your ATS, marketplace, agency platform, or internal hiring system. One POST to trigger an interview, one webhook to get the scorecard back.
API access is partner-gated today: no public keys or self-serve console yet. Request sandbox access and we scope your integration on a short call before you write a line of code.
POST /v1/evaluations { "candidate_ref": "ats-cand-7841", "role": "senior-llm-engineer", "focus_areas": ["rag", "evals", "production-llm"], "webhook_url": "https://ats.example.com/hooks/recruo"} # 200 OK — evaluation created, candidate invited{ "evaluation_id": "eval_9f2c4a", "status": "invited", "candidate_ref": "ats-cand-7841"}Illustrative example — field names simplified; the exact contract is shared during partner onboarding.
Integration surface
What the integration looks like
These samples are illustrative of the product surface Recruo already runs for its own hiring mandates: trigger an AI technical interview, poll status while the candidate completes it, and receive a structured, human-reviewed scorecard on your webhook. No invented endpoints — just the real workflow expressed as code.
# Recruo → POST https://ats.example.com/hooks/recruo{ "event": "evaluation.completed", "evaluation_id": "eval_9f2c4a", "candidate_ref": "ats-cand-7841", "scorecard": { "overall_score": 87, "verdict": "PROCEED", "hard_skills": { "average_score": 8.6, "questions": [ { "topic": "rag-architecture", "score": 9 }, { "topic": "eval-suite-design", "score": 9 }, { "topic": "fine-tuning-tradeoffs", "score": 8 } ] }, "english": { "score": 8, "cefr_level": "C1" }, "ai_skills_evidence": [ "llm-as-judge calibration", "regression-gated prompt changes" ], "secure_browser": { "locked_session": true, "integrity_flags": [] }, "human_review": { "reviewed": true, "verdict": "Proceed to final interview" } }}Scorecard values mirror the real sample on the scorecard page: overall 87/100, hard-skills average 8.6/10, English C1, human-reviewed verdict.
What the scorecard carries
- Hard-skills scores — per-question technical scoring with written evaluation and takeaway for each answer.
- English assessment — CEFR-mapped communication level from the live interview, not a self-reported claim.
- AI-skills evidence — concrete signals of applied LLM engineering ability: eval design, RAG trade-offs, judge calibration.
- Secure-browser signals — session integrity flags from the locked-down Recruo Secure Browser environment.
- Human-review verdict — a recruiter-reviewed recommendation your team can defend in a hiring decision.
Endpoint overview
| Action | Surface | What it does |
|---|---|---|
| POST | /v1/evaluations | Create an evaluation: candidate reference, role, focus areas, and the webhook URL where the scorecard should land. Returns an evaluation ID. |
| GET | /v1/evaluations/{id} | Check status as the candidate moves through the flow: invited, in progress, under human review, completed. |
| WEBHOOK | evaluation.completed | Recruo calls your endpoint with the structured scorecard: scores, AI-skills evidence, secure-browser signals, and the human-reviewed verdict. |
Illustrative overview, not a public API reference — there is no public docs site yet. The full contract, sandbox credentials, and webhook signing details come with partner onboarding.
How the integration works
ATS to scorecard in four steps
A practical REST and webhook pattern for teams that want the evaluation output inside the tools they already use — Greenhouse, Lever, Ashby, Workable, SmartRecruiters, an agency CRM, or an internal hiring system.
Trigger an evaluation
Your ATS, agency CRM, or hiring platform creates an evaluation request when a candidate reaches the technical-screen stage.
Send role and candidate context
Recruo receives the role, seniority, focus area, candidate details, and evaluation requirements needed to run the interview.
Run technical validation
The candidate completes an AI technical interview with secure-browser controls, AI-skills validation, and human review.
Return scorecard output
Your system receives status updates, scorecard summaries, and exportable evidence for hiring managers and recruiters.
Recruo Secure Browser
Interviews can run in a fully locked-down session — no tab switching, no external apps — so the signals behind every scorecard stay defensible.
Human-in-the-loop
A human recruiter reviews every evaluation before it reaches your system, keeping AI-assisted output accountable and auditable.
EU AI Act aligned
GDPR-aware processing, candidate consent, audit evidence, and consistent rubrics keep the workflow ready for compliance review.
Use cases
Where the integration creates leverage
Written for teams that already have a hiring workflow and want Recruo's technical evaluation layer inside it — not another tool to log in to.
Scale-up hiring teams
Bring Recruo evaluation into the existing ATS process before engineering interviews consume team time.
Recruitment agencies
Add stronger technical validation to shortlists while keeping recruiters inside their agency CRM workflow.
Talent marketplaces
Attach consistent engineering scorecards to marketplace candidates before they are presented to customers.
ATS-adjacent platforms
Offer evaluation results as part of a sourcing, screening, or workflow automation product.
Compliance-minded employers
Keep audit evidence, human review, and consistent rubrics close to hiring decisions.
Internal hiring systems
Route candidate evaluation data into internal dashboards, approval flows, or hiring operations tooling.
Product proof
Built from the evaluation system already used in Recruo hiring
The integration story is anchored in visible product proof: structured AI interviews, scorecards, secure-browser validation, human review, and compliance posture.
Sample scorecard
See the structured evaluation output: recommendation, per-question scoring, English assessment, and red flags.
Evaluation workflow
Review the broader six-step Recruo process behind the technical interview and shortlist delivery.
Security and compliance
Understand GDPR, EU AI Act posture, human review, candidate consent, and audit controls.
AI skills validation
Read how AI-assisted engineering skills can be evaluated without relying on outdated interview signals.
AI cheating in interviews
Why secure-browser validation and evidence capture matter for remote technical assessment.
Recruiting MCP server
Explore the agent-native companion page for teams exposing evaluation tools to hiring assistants.
FAQ
Questions integration buyers usually ask first
Short answers for search visitors and procurement-minded teams before they start an integration conversation.
How would the AI technical interview API fit into an ATS workflow?
A hiring platform or ATS can trigger an evaluation when a candidate reaches the technical-screen stage, send role and candidate context to Recruo, then receive status updates and a structured scorecard for the hiring team.
Does this replace our ATS?
No. The API is for teams that want Recruo as the evaluation layer inside their existing workflow. Your ATS or internal hiring system remains the system of record.
What does the returned scorecard include?
The scorecard can include per-question technical scoring, English communication assessment, AI-skills signals, red flags, strengths, and a human-reviewed recommendation summary.
Is there human review in the process?
Yes. Recruo positions the evaluation output as AI-assisted and human-reviewed, which supports better judgment and a clearer audit trail for hiring decisions.
How do you handle compliance-sensitive hiring workflows?
Every evaluation runs under the Recruo security and compliance posture: GDPR-aware processing, human-in-the-loop review, audit evidence, and EU AI Act aligned hiring controls.
Can we sign up for a public self-serve API today?
Not yet. API access is partner-gated: there is no public developer console or self-serve API keys today. Request sandbox access or book a scoping call, and we set up the integration together during partner onboarding.
API sandbox access
Add Recruo evaluation to your hiring workflow.
Tell us about your ATS, marketplace, agency platform, or internal hiring system. We'll reply within 24 hours about sandbox access and private API integration.