---
title: "Get Lead Finder Candidates"
method: GET
path: "/api/experiments/{key}/lead-finder/candidates"
tags: ["Experiments"]
---

# Get Lead Finder Candidates

`GET /api/experiments/{key}/lead-finder/candidates`

Segments that COULD join this experiment.

Write-scoped although it only reads, and deliberately so: the answer is
not about this experiment at all — it ranks every outreach segment in the
company by how much cold mail it has already sent, naming the client's
project domain next to each. That is a cross-client commercial readout,
and the read token is handed to every A/B researcher precisely as a token
that cannot do anything but read their own experiment's numbers
(``.agents/commands/hats/ab-researcher.md``). It is also an operator's
tool — the input to choosing segments — not part of the readout.

## Path parameters

- `key` string, required

## Headers

- `x-admin-token` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/explee/apis/explee-api.md) · [All operations](https://skmtc.dev/explee/apis/explee-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/explee/explee-api/revisions/f169bc6e9447/schema)