Lead Deletion Status API

Check the status of a lead deletion request. Lead deletion is processed asynchronously to handle cleanup of associated events, scores, and aliases.

GET /lead/{leadID}/deletion

Get the deletion status for a specific lead.

Parameter	Type	Required	Description
`leadID`	string	Yes	Lead identifier (path parameter)

200 OK

{
  "lead_id": "ld_123",
  "status": "completed",
  "requested_at": "2025-01-15T10:00:00Z",
  "completed_at": "2025-01-15T10:05:00Z"
}

Field	Type	Description
`lead_id`	string	Lead identifier
`status`	string	Deletion status: `pending`, `in_progress`, `completed`, `failed`
`requested_at`	timestamp	When deletion was requested
`completed_at`	timestamp	When deletion completed (null if still in progress)

curl -X GET "https://api.leadvibe.com/lead/ld_123/deletion" \
  -H "Authorization: Bearer <token>"

Status	Meaning	Solution
401	Unauthorized	Check authentication token
404	Not Found	No deletion request exists for this lead

Deletion removes the lead and all associated events, scores, aliases, and metadata
Deletion is irreversible once completed
Large leads with many events may take several minutes to fully delete
Deletion status is OU-scoped to the active Organizational Unit