---
title: "Match a single resume and job description"
method: GET
path: "/v3/resume_search/match"
tags: ["Search & Match"]
---

# Match a single resume and job description

`GET /v3/resume_search/match`

Get the matching score between a resume and a job description. The score ranges between 0 and 1, with 0 being not a match at all, and 1 being perfect match.<br/> Note, this score will not directly match the score returned from POST [/resume_search/details/{identifier}](#post-/resume_search/details/-identifier-).

## Query parameters

- `resume` string, required
- `job_description` string, required
- `index` string
- `search_expression` string
- `job_titles_weight` number
- `years_experience_weight` number
- `locations_weight` number
- `languages_weight` number
- `skills_weight` number
- `education_weight` number
- `search_expression_weight` number
- `soc_codes_weight` number
- `management_level_weight` number

## Response `200`

The matching score between the provided resume and job description.

- ResumeSearchMatch
  - `score` number — The matching score between the provided resume and job description.
  - `details` object
    - `jobTitle` JobTitleSearchScoreComponent
      - `value` string
      - `label` string, required
      - `score` number, nullable
    - `managementLevel` ManagementLevelSearchScoreComponent
      - `value` string
      - `label` string, required
      - `score` number, nullable
    - `experience` ExperienceSearchScoreComponent
      - `value` string
      - `label` string, required
      - `score` number, nullable
    - `skills` SkillsSearchScoreComponent
      - `value` string
      - `label` string, required
      - `score` number, nullable
    - `languages` LanguagesSearchScoreComponent
      - `value` string
      - `label` string, required
      - `score` number, nullable
    - `location` LocationSearchScoreComponent
      - `value` string
      - `label` string, required
      - `score` number, nullable
    - `education` EducationSearchScoreComponent
      - `value` string
      - `label` string, required
      - `score` number, nullable
    - `occupationGroup` OccupationGroupSearchScoreComponent
      - `value` string
      - `label` string, required
      - `score` number, nullable
    - `searchExpression` SearchExpressionSearchScoreComponent
      - `label` string, required
      - `value` string
      - `score` number, nullable

## Other responses

- `400` — Bad request. If it is a validation error will contain a list of each invalid field
- `401` — Authorisation error
- `default` — UnexpectedError

---

[API](https://skmtc.net/affinda/apis/affinda-api.md) · [All operations](https://skmtc.net/affinda/apis/affinda-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/affinda/affinda-api/versions/5f71e092a3e8/schema)