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.For Search and Extract, use /v1/search and /v1/extract for all new integrations and agent tool calls. Use /v1beta/search and /v1beta/extract only when maintaining an existing integration that already uses them. Do not substitute /v1 for the documented FindAll or Ingest endpoint paths.
Stop a running FindAll search when you have enough matches or need to control costs. Results found before cancellation are preserved.

​
How Cancellation Works

The cancel endpoint marks the run cancelled and returns 204 No Content. The orchestrator then detects that terminal state and stops scheduling more work:
  • Work already in flight may finish before orchestration shuts down
  • Candidates already persisted remain accessible through /result
  • Cancellation does not reverse charges for work that already completed
  • Current FindAll runs move directly to cancelled; they do not emit an intermediate cancelling status (see Run Lifecycle)
Cancelled runs cannot be extended. Results found before cancellation remain available. Adding an enrichment to a terminal run requeues it, so create a new run instead if you want an independent search.

​
Common Use Cases

  • Control costs when a run takes longer than expected
  • Stop after finding enough matches (monitor via webhooks or SSE)
  • Iterate quickly with refined queries instead of waiting for completion
  • 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