Cancel Bulk Lookalike Job
Cancel a running or pending bulk lookalike job. Submit a job first via POST /api/v1/account/search-lookalikes-bulk (“Search Lookalikes Bulk”, under Company Search), which returns a job_id.
X-API-Key - the only required header for this endpoint.The job moves to a transient cancelling state and stops at its next checkpoint. Whatever pages were already produced are kept and remain readable via the poll endpoint, and you are charged only for the companies actually delivered before the cancel - nothing for the abandoned remainder. The job then settles to a terminal cancelled status.
Returns 409 if the job has already finished (completed / failed / cancelled), and 404 if no job with that id exists for your API key. Poll GET /api/v1/account/search-lookalikes-bulk/{job_id} for the final cancelled state and the partial results.
When to cancel
Cancel when finishing the job is no longer worth it - e.g. you requested a large limit but already have enough companies from the pages delivered so far, the query turned out too broad, or you simply want to stop spend. Because credits are billed only for companies actually delivered before the cancel (never the abandoned remainder), cancelling early is how you cap credit usage on an over-scoped job.
Headers
Path Parameters
The job_id returned by the bulk submit endpoint.
Response
Cancellation accepted; the job is now cancelling.
Acknowledgement returned by the bulk-lookalike cancel endpoint. Cancellation is asynchronous - poll the GET endpoint for the final cancelled state and the companies processed before the cancel.