> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.ada.cx/release-notes/2026/7/14/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.ada.cx/_mcp/server.

# Bulk End-User Deletion API

The Bulk End-User Deletion API is now available. It erases all personal data associated with one or more end users across Ada's systems, supporting compliance with data deletion requirements such as GDPR.

## API endpoints

Two REST endpoints are available:

* **Submit a deletion request** (`POST /v2/end-users/delete`): Accepts up to 1000 identifiers and returns a `job_id` for tracking. Requests are idempotent for 24 hours.
* **Get a deletion job** (`GET /v2/jobs/{job_id}`): Returns the job status and a per-identifier outcome for each submitted identifier.

Identifiers can be supplied by email, external ID, or Ada's end-user identifiers, or matched by a stored variable. A job is accepted quickly, but erasure runs downstream across every data store, so reaching `completed` can take up to 30 days.

## Get started

* [Bulk End-User Deletion API reference](/reference/end-users/bulk-deletion/overview) for identifier types, dispositions, job lifecycle, error codes, and rate limits.