---
title: Candidate Comparison API
slug: compare-candidates-head-to-head
url: https://apyverse.com/namastesumalya/service/compare-candidates-head-to-head
provider: Sumalya APIs
categories: [Artificial Intelligence, HR]
tags: [hr-tech, recruiting, resume-analysis, candidate-comparison, talent-screening]
auth: api_key
---

# Candidate Comparison API

Compare two resumes against a job title and get a winner, rationale, and skill-by-skill breakdown for screening and hiring workflows.

## Endpoints

| Method | Path | Description | Atoms |
| --- | --- | --- | --- |
| POST | `/namastesumalya/api/compare` | What it does Compares two candidate resumes against each other, with an optional job title context,… | 1000 |

## About

## What it does
Candidate Comparison lets you compare two resumes against a job title and get a structured head-to-head result. Send `resumeA`, `resumeB`, and `jobTitle`, and the API returns a `winner`, a short `rationale`, and a `comparisonMatrix` with separate notes for `experience`, `softSkills`, and `technicalSkills`.

Use it when you need a fast screening layer for hiring workflows, shortlist generation, or internal review tools. It helps you turn unstructured resume text into a consistent comparison that recruiters, hiring managers, or matching systems can read quickly.

The response is explicit: one candidate is selected as the winner, and the comparison matrix explains the tradeoffs behind that decision. That makes it easier to surface why one resume is a better fit for a role, rather than relying on a single score with no context.

If you are building an ATS, recruiting assistant, or candidate triage flow, Candidate Comparison gives you a simple API for pairwise resume evaluation without having to parse the reasoning yourself.

## Usage

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