---
title: Resume/CV Job Match Score API
slug: resume-cv-job-match-score
url: https://apyhub.com/sharpapi/service/resume-cv-job-match-score
provider: SharpAPI
categories: [Model Kit, Document Intelligence Kit]
tags: [cv, hr, resume, job]
auth: api_key
version: 1.0.0
service_type: job
endpoints: 2
atoms: 1-1000
alias: sharpapi-resume-job-match-score
---

# Resume/CV Job Match Score API

Compare a resume file against a plain-text job description. Returns match scores, explanations, and job status for recruiter screening and ATS.

## Endpoints

| Method | URL | Description | Atoms |
| --- | --- | --- | --- |
| POST | `https://api.eu.apyhub.com/sharpapi/resume-cv-job-match-score` | What it does Submits a resume/CV and a job description for an asynchronous match-score job. The end… | 1000 |
| GET | `https://api.eu.apyhub.com/sharpapi/resume-cv-job-match-score/job/status/:job_id` | What it does Checks the status of a resume/CV job match scoring job by its jobid and returns the jo… | 1 |

## Endpoint reference

### Resume/CV Job Match Score - Submit Job

`POST https://api.eu.apyhub.com/sharpapi/resume-cv-job-match-score` · 1000 atoms · accepts `multipart/form-data` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `file` | body | string (binary) | yes | Resume/CV file (PDF, DOCX, TXT, etc.). |
| `content` | body | string | yes | Full job description in plain text. |
| `language` | body | string | no | Language for explanations. Default: `English`. |

#### Quickstart

Upload a resume and a job description to get a matching job submission started.

```bash
curl -X POST "https://api.eu.apyhub.com/sharpapi/resume-cv-job-match-score" \
  -H "apy-token: $APY_TOKEN" \
  -F "file=@/path/to/resume.pdf" \
  -F "content=We are looking for a Python engineer with experience in APIs and cloud infrastructure."
```

#### What you'll get back

Returns a JSON object with a `job_id` string — the UUID of the submitted job. Poll the job status endpoint with this id to retrieve the result.

```json
{
  "job_id": "a8b764e9-5011-4770-afc5-aedf1769bd8e"
}
```

### Resume/CV Job Match Score - Check Job Status

`GET https://api.eu.apyhub.com/sharpapi/resume-cv-job-match-score/job/status/:job_id` · 1 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `job_id` | path | string (uuid) | yes |  |

#### Quickstart

Check the status of a job by its UUID in the path.

```bash
curl -X GET "https://api.eu.apyhub.com/sharpapi/resume-cv-job-match-score/job/status/:job_id" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with a `data` object. Inside `data`, `id` is the job result UUID, `type` is the resource type, `attributes` contains the result details, and `status` is one of `running`, `failed`, `queued`, or `success`.

```json
{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "type": "api_job_result",
    "attributes": {
      "type": "hr_resume_job_match_score",
      "result": {
        "match_scores": {
          "overall_match": 85.5
        },
        "explanations": {
          "skills_match": "Strong alignment with the role requirements."
        }
      }
    },
    "status": "success"
  }
}
```

## About

## What it does

Resume Job Match Score compares a resume or CV against a job description and returns structured match results for hiring workflows. Send a resume file plus the job description text, and get back a job ID for polling.

Use it when you want to screen applicants consistently before a recruiter reviews them. The submit endpoint accepts a binary file in PDF, DOCX, TXT, or similar formats, along with the job description in plain text. You can also set the language used for explanations.

When the job completes, the status endpoint returns a result object with match scores and human-readable explanations. The scores cover overall_match and a range of hiring signals such as skills_match, experience_match, education_match, soft_skills_match, technical_stack_match, job_title_relevance, recent_role_relevance, certifications_match, project_experience_match, and more. The response also includes the job status, so you can track whether the analysis is queued, running, successful, or failed.

Resume Job Match Score is a fit for ATS enrichment, recruiter triage, and shortlist ranking where you need both a numeric comparison and transparent reasoning behind it.

## Usage

Base URL: `https://api.eu.apyhub.com` (default region — see
`GET https://apyhub.com/api/public/regions` for the rest).

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/sharpapi/service/resume-cv-job-match-score
