> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firsttouch.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> For API operations, fetch https://gateway.firsttouch.ai/api/public/openapi.json for the complete input/output schemas, internal references, and x-mcp-annotations. Endpoint Markdown intentionally omits generated schema fragments. Select /api/public/tools/<tool_name> using the exact underscore-separated name. Send requests to https://gateway.firsttouch.ai; the canonical document currently omits servers. Start at https://docs.firsttouch.com/api-reference/agent-start.md.

# List Flow Enrollment Candidates

> Requires the admin team role or global admin access. Check get_current_user.toolAccess before calling.

Lists compact enrollment candidate records for one flow plan, newest first.

<details>
<summary><strong>Detailed usage guidance</strong></summary>
<ul>
<li>Defaults to Awaiting; this includes Awaiting candidates whose enrollment has already been requested, so inspect canEditCustomVariables.</li>
<li>Set status=null for all statuses.</li>
<li>Does not return custom input values; use get_flow_candidate for one candidate&#39;s full dictionary.</li>
<li>Candidate ids can be used in enroll_awaiting_flow_items and cancel_awaiting_flow_items where eligible.</li>
<li>Keep the same flowPlanId, status, and searchQuery across cursor pages.</li>
</ul>
</details>



## API Specification

The full API specification for this endpoint is available in the [documentation index](https://docs.firsttouch.com/llms.txt).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.