---
title: Advanced Shortlist API
slug: executive-level-shortlist
url: https://apyhub.com/namastesumalya/service/executive-level-shortlist
provider: Sumalya APIs
categories: [Artificial Intelligence, HR]
auth: api_key
---

# Advanced Shortlist API

Rank resume summaries against a job title and return topCandidates plus an executiveReport. Useful for fast HR screening and shortlist review.

## Endpoints

| Method | Path | Description | Atoms |
| --- | --- | --- | --- |
| POST | `/namastesumalya/api/shortlist` | What it does Generates an executive-level shortlist from the submitted resumes and job title. The r… | 500 |

## About

## What it does
Executive Shortlist ranks a set of resumes against a job title and returns the strongest matches, plus a short report you can use to review the overall pool.

Send a `jobTitle` and an array of `resumes` as plain text. The response gives you `topCandidates`, each with a `name`, `rank`, and `fitReason`, so you can surface the best-fit people and see why they were chosen. It also returns an `executiveReport` string that summarizes the strengths and gaps across the candidate pool.

Use Executive Shortlist when you need a fast first pass on a hiring pipeline: screening applicants for a senior ML role, comparing internal candidates for promotion, or preparing a concise briefing for recruiters and hiring managers. The output is structured enough to feed into an HR workflow, shortlist dashboard, or internal review tool without extra parsing.

Because the service works from resume text rather than parsed CV fields, it fits early-stage triage and bulk review where you already have candidate summaries and want an ordered shortlist with a brief rationale.

## Usage

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/namastesumalya/service/executive-level-shortlist