Skip to main content

Delete companies in bulk

DELETE 
/v2/companies/bulk/:lookupKey

Removes every company named in the body, each read with the :lookupKey from the URL.

Each key is deleted exactly as the single delete would delete it — a company that still has contacts attached is refused, and every deleted company emits its own event.

A key that cannot be deleted does not fail the request: it lands in failedIds with an entry in failures saying why, and the rest of the batch is deleted regardless. Repeated keys are collapsed, so a key sent twice gets one verdict.

Request​

Responses​

Bulk delete completed. Read failures for the keys that were not deleted.