---
title: "List Candidates"
method: GET
path: "/v1/admin/substack/candidates"
tags: ["substack-wedge"]
---

# List Candidates

`GET /v1/admin/substack/candidates`

## Request

- Base URL: `https://api.storyflo.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.storyflo.com/v1/admin/substack/candidates`
- Auth: none declared

Paginated listing. Newest-first by ``discovered_at``.

## Query parameters

- `publisher_domain` string, nullable
- `status` string, nullable
- `limit` integer

## Headers

- `x-storyflo-email-token` string, nullable

## Response `200`

Successful Response

- CandidateView[]
  - `id` string, required
  - `publisher_domain` string, required
  - `post_url` string, required
  - `title` string, required
  - `published_at` string, date-time, nullable, required
  - `is_paywalled` boolean, required
  - `excerpt` string, required
  - `has_full_content` boolean, required
  - `status` string, required
  - `discovered_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/storyflo/apis/storyflo-inference-router.md) · [All operations](https://skmtc.dev/storyflo/apis/storyflo-inference-router/llms.txt) · [OpenAPI document](https://skmtc.dev/storyflo/apis/storyflo-inference-router/revisions/c3a1a735ac7a?raw)