Skip to main content
Stop a running FindAll search when you have enough matches or need to control costs. Results found before cancellation are preserved. 
curl -X POST \
  https://api.parallel.ai/v1beta/findall/runs/findall_40e0ab8c10754be0b7a16477abb38a2f/cancel \
  -H "x-api-key: $PARALLEL_API_KEY" \
  -H "parallel-beta: findall-2025-09-15" \
  -H "Content-Type: application/json"

​
How Cancellation Works

Cancellation is a signal, not instant:
  • Active work units finish gracefully, no new work is scheduled
  • Matches found so far are preserved and accessible
  • You’re charged for work completed during cancellation
  • After cancellation, the run transitions to cancelled status (see Run Lifecycle)
Cancelled runs cannot be extended or enriched. Cancellation is irreversible—you’ll need to create a new run to continue searching.

​
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 ~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