Endpoint Reference

Score Match (Pre-parsed)

Score a candidate's resume against a pre-parsed job description using the job_id from /parse-job. Faster and more consistent than /score-match.

Optimized for bulk candidate screening.

By using pre-parsed job data, this endpoint eliminates redundant JD processing. Perfect for screening multiple candidates against the same role.

Faster Scoring

Skips JD parsing — goes straight to matching against structured data.

Consistent Results

Same structured JD interpretation for every candidate — no AI variance.

Cached Analysis

Same resume + same job returns cached results instantly.

Batch Friendly

Parse one job, score hundreds of resumes against it efficiently.

POST/v1/score-match-parsed

Request Parameters

Name	Type	Description
fileRequired	file	The resume file to analyze (PDF, DOCX, TXT).
job_idRequired	string	The job_id returned from /parse-job.
language	string	Language code for analysis (default: 'en').

🌍 Supported Languages50

afAfrikaans

amAmharic

arArabic

bgBulgarian

bnBengali

csCzech

daDanish

deGerman

elGreek

enEnglish

esSpanish

etEstonian

faPersian

fiFinnish

frFrench

guGujarati

heHebrew

hiHindi

hrCroatian

huHungarian

idIndonesian

itItalian

jaJapanese

knKannada

koKorean

ltLithuanian

lvLatvian

mlMalayalam

mrMarathi

msMalay

nlDutch

noNorwegian

plPolish

ptPortuguese

roRomanian

ruRussian

skSlovak

slSlovenian

srSerbian

svSwedish

swSwahili

taTamil

teTelugu

thThai

tlTagalog

trTurkish

ukUkrainian

urUrdu

viVietnamese

zhChinese

Pro Tip

Combine with /parse-job for a two-step workflow: first parse the job (once), then score each candidate's resume against the parsed job data.

curl -X POST https://api.evalcv.com/v1/score-match-parsed \
  -H "x-api-key: YOUR_API_KEY" \
  -F "file=@resume.pdf" \
  -F "job_id=a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
  -F "language=en"