---
title: "Advanced Shortlist API"
slug: executive-level-shortlist
url: https://apyverse.com/namastesumalya/service/executive-level-shortlist
provider: Sumalya APIs
categories: [Artificial Intelligence, HR, Smart Generation]
tags: [hiring, candidate-ranking, resume-screening, talent-shortlist, recruiting]
auth: api_key
---

# Advanced Shortlist API 

Rank resume text against a job title and get topCandidates plus an executiveReport. Useful for fast senior-role screening and hiring triage.

## Endpoints

| Method | Path | Description | Atoms |
| --- | --- | --- | --- |
| POST | `namastesumalya/api/shortlist` | What it does Creates an executive-level shortlist from submitted resume text for a given job title.… | 500 |

## About

## What it does
Executive Candidate Shortlist ranks resumes against a job title and returns a concise shortlist with an executive summary of the pool.

Send a `jobTitle` and an array of `resumes` as plain text. The service evaluates the candidates for the role, then returns `topCandidates` with each candidate’s `name`, `rank`, and `fitReason`, plus an `executiveReport` that highlights the overall strengths and gaps in the pool.

Use Executive Candidate Shortlist when you need a fast first pass on a hiring slate for a senior engineering, product, or leadership role. It is useful for screening large batches of resume text before a recruiter or hiring manager spends time on deeper review.

The response is structured for downstream automation: you can sort, display, or route the ranked candidates into an internal hiring workflow, while the executive report gives a compact readout on how well the group matches the role.

## Usage

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