Private beta — access by request

Candidate Tools API

Add evidence-grounded CV and job analysis to your platform.

Send a PDF, DOCX document or extracted CV text. Receive a consistent candidate profile, compare it with a real opportunity and generate evidence-grounded interview preparation through structured JSON APIs.

Use the complete workflow or integrate only the endpoints your product needs. You own the user experience; Domville Tech provides the analysis.

Structured JSONresponses your product can use
Evidence tracedto supplied content
Human reviewretained in the workflow
Usage pricedcompleted calls, not seats

One integration

Add candidate preparation to the product you already have.

01

Your interface

Keep your branding, customer relationship and workflow.

02

Stable output

Use versioned data rather than unpredictable generated prose.

03

Evidence grounding

Conclusions retain supporting information from the supplied CV.

04

Human control

Your users review outputs before they are used or shared.

05

Metered usage

Pay for completed API calls rather than user seats.

06

Headless by design

Fit the analysis behind your existing customer experience.

How it works

Three focused endpoints. One consistent candidate model.

InputPDF / DOCX / Text
ParsePOST /v1/cv-parses

Convert a supported CV into a versioned CandidateProfile.

AnalysePOST /v1/application-analysis

Identify supported, partially supported and unevidenced requirements.

PreparePOST /v1/interview-preparation

Generate interview preparation grounded in supplied evidence.

PresentCustomer application

Use the response in your own product, reports or adviser workflow.

Private-beta usage pricing

Use one endpoint or the complete workflow.

01 · CV Parsing API

POST /v1/cv-parses

Convert a standard PDF, DOCX or UTF-8 text CV into a consistent CandidateProfile.

£0.20 + VAT per successful standard parse

02 · Application Analysis API

POST /v1/application-analysis

Map supplied candidate evidence against the requirements of a real opportunity.

£1.25 + VAT per successful analysis

03 · Interview Preparation API

POST /v1/interview-preparation

Generate role-specific preparation grounded in the candidate’s supplied experience.

£0.50 + VAT per successful request

Complete workflow

Parse, analyse and prepare

One standard CV parse, one application analysis and one interview-preparation response.

£1.65 + VAT

No subscription is required during the private beta. Production access starts with £25 of prepaid API credit, usable across any endpoint.

  • No charge for failed or unusable responses
  • Idempotent retries are not charged twice
  • Structured candidate data can bypass parsing
  • Volume pricing can be discussed

Fictional examples

See what the API returns.

Missing evidence is reported as uncertainty or a clarification question. The API should not invent qualifications, employment history or achievements.

CandidateProfile

{
  "profile_id": "profile_example_123",
  "schema_version": "1.0",
  "skills": [
    {
      "raw_value": "ASP.NET Core net8",
      "normalised_value": ".NET 8",
      "confidence": 0.93,
      "source_references": [
        { "page": 2, "text": "ASP.NET Core net8" }
      ]
    }
  ],
  "warnings": []
}

Application analysis

{
  "requirement": "Experience mentoring developers",
  "status": "supported",
  "evidence": [
    {
      "text": "Mentored team members on architecture and coding standards",
      "source": "cv"
    }
  ],
  "confidence": 0.91
}

Interview preparation

{
  "topic": "Technical leadership",
  "question": "How did you support architecture decisions?",
  "evidence_reference": "cv:employment:2",
  "clarify": [
    "scope",
    "measured outcome"
  ]
}

Expected production integration

HTTPS and JSONAPI-key authenticationVersioned schemasIdempotency keysClear error responsesUsage information

Responsible use

Candidate support with human judgement retained.

Designed for

  • Candidate application preparation
  • Adviser and coach support
  • Evidence mapping
  • CV improvement guidance
  • Interview preparation
  • Human-reviewed workflows

Not designed for

  • Hire or reject decisions
  • Automatic shortlisting or ranking
  • Overall suitability scores
  • Personality profiling
  • Protected-characteristic inference
  • Fully automated employment decisions

Candidate information should not be processed through the service until the relevant retention, deletion, security and data-processing arrangements have been documented and agreed. Read the privacy notice.

Private-beta access

Evaluate the outputs before committing to an integration.

Request access to review the schemas, test fictional or appropriately redacted information and discuss expected production usage.

The initial evaluation includes ten no-charge requests. Access is arranged directly.

Request private beta access

Who should integrate it

For products that already own the candidate experience.

01

Career platforms

Add job-specific CV and interview support to an established candidate experience.

02

Outplacement providers

Bring consistent evidence and preparation outputs into existing adviser workflows.

03

Training platforms

Help learners connect their experience and new skills with real opportunities.

04

Recruitment technology

Add candidate-support functionality without building a separate analysis engine. It is not intended for ranking, shortlisting or rejection.

Practical implementation experience

Built by an experienced software and AI practitioner.

Candidate Tools API is developed by Domville Tech, drawing on more than 25 years of delivery experience with .NET, Azure, OpenAI, structured outputs, document analysis and production business systems.

Frequently asked questions

Before requesting access

Which CV formats are supported?

The private-beta scope covers standard PDF, DOCX and extracted UTF-8 text. Image-only documents are not included unless an OCR capability is explicitly agreed.

Can we provide candidate data that is already structured?

Yes. Customers can provide a CandidateProfile directly for application analysis and skip the parsing call and charge.

Does the API rank or shortlist candidates?

No. It supports application preparation and human-reviewed guidance, not candidate ranking, shortlisting or rejection.

How does it avoid inventing candidate information?

Outputs retain source evidence, confidence and clarification points. Missing evidence is made visible rather than replaced with invented qualifications or experience.

How is candidate information handled?

Use fictional or appropriately redacted information until production retention, deletion, security and data-processing arrangements have been agreed.

How are API calls charged?

Private-beta pricing is based on successful calls. Production access starts with £25 of prepaid credit, with no subscription required during the beta.

Private-beta access

See whether the outputs fit your product.

Request access to review the schemas, test representative information and discuss expected production usage.