Human resources · list_candidates
List candidates
Candidates for a role with score and stage, from the pipeline or straight from the connected ATS.
- Price
- included
- Requirements
- No connector
- also works with Greenhouse, Lever, Recruitee
- Human approval
- No
- read or internal write
- Reliability
- Verified
- not measured yet
Input
| Field | Type | Description |
|---|---|---|
| position | string | Position / job title (partial, case-insensitive) |
| status | array | Statuses to include (default: new, screening, interview, offer) |
| query | string | Partial name or email |
| minScore | number | Only candidates with fitScore >= this value |
| limit | number | Max rows (1-200, default 50) |
| from | pipeline | ats | pipeline (default): the Ezyagents pipeline. ats: read the connected ATS (Greenhouse, Lever or Recruitee) directly, with the stage of each candidate. |
Call this tool
Through the HTTP API, or from the MCP server with the run meta-tool.
curl https://api.ezyagents.fr/gateway/v1/run \
-H "Authorization: Bearer ezk_…" -H "Content-Type: application/json" \
-d '{"tool":"list_candidates","input":{"position":"…","status":[],"query":"…","minScore":1}}'$
run({ "tool": "list_candidates", "input": {"position":"…","status":[],"query":"…","minScore":1} })