---
title: Candidate Comparison API
slug: compare-two-candidates-head-to-head
url: https://apyhub.com/namastesumalya/service/compare-two-candidates-head-to-head
provider: Sumalya APIs
categories: [Artificial Intelligence, HR, Smart Generation]
tags: [candidate-comparison, resume-screening, hiring, talent-acquisition, job-fit, llm-ranking]
auth: api_key
---

# Candidate Comparison API

Compare two resumes against a job title and get a winner, rationale, and skill-by-skill matrix for hiring review and shortlist ranking.

## Endpoints

| Method | Path | Description | Atoms |
| --- | --- | --- | --- |
| POST | `/namastesumalya/api/compare` | What it does Compares two candidate resumes against a job title and returns a winner, a rationale,… | 1000 |

## About

## What it does
Candidate Comparison compares two resumes against a job title and returns a structured head-to-head assessment. Send `resumeA`, `resumeB`, and `jobTitle`, and get back a `winner`, a short `rationale`, and a `comparisonMatrix` covering `experience`, `softSkills`, and `technicalSkills`.

Use it when you need a fast first-pass screen before a recruiter or hiring manager reviews the full packet. It helps you turn unstructured resumes into a consistent comparison for the same role, which is useful for shortlist ranking, interview triage, or building an internal hiring workflow that needs a clear recommendation.

The response is simple to consume: one candidate is identified as the winner, with supporting text for why they were chosen. The comparison matrix breaks the decision into specific dimensions so you can show the basis for the result in your own UI or audit trail.

Candidate Comparison is designed for resume-to-role evaluation, not general document parsing. If your workflow starts with two candidate resumes and a target position, this endpoint gives you a direct, machine-readable comparison.

## Usage

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/namastesumalya/service/compare-two-candidates-head-to-head