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 normally progress from queued → running → a terminal state (completed, failed, or cancelled). The response schema also defines cancelling and action_required for compatibility with the shared run-status contract. A run is active when status.is_active is true. The shared status schema treats queued, running, and cancelling as active, although current FindAll cancellation moves directly from an active state to cancelled.

​
Status Definitions

You can extend a non-preview run while it is queued or running. A completed run can be extended only when its termination_reason is match_limit_met. Enrichments can be added after creation; adding one to any terminal run requeues that run while the enrichment is processed. Cancellation applies to active runs.

​
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 5–10 evaluated 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