Skip to main content
For AI agents: a documentation index is available at https://docs.parallel.ai/llms.txt. The full text of all docs is at https://docs.parallel.ai/llms-full.txt. You may also fetch any page as Markdown by appending .md to its URL or sending Accept: text/markdown.

​
Run Statuses and Termination Reasons

FindAll runs progress from queued → running → terminal state (completed, failed, or cancelled). A run is considered active when it has status queued, running and has active candidate generation, evaluation, and enrichments ongoing.

​
Status Definitions

* See termination reasons below for extendability

​
Termination Reasons

When a run reaches a terminal state, it will have one of these termination reasons:
  • Generators and Pricing: Understand generator options and pricing
  • Preview: Test queries with ~10 candidates before running full searches
  • Enrichments: Extract additional structured data for matched candidates
  • Extend Runs: Increase match limits without paying new fixed costs
  • Streaming Events: Receive real-time updates via Server-Sent Events
  • Webhooks: Configure HTTP callbacks for run completion and matches
  • API Reference: Complete endpoint documentation