Skip to main content

​
DELETE /api/v1/public/lead-lists/:id/delete-leads/

Delete (archive) prospects or companies from a lead list. For people lists, prospects are archived (not permanently deleted). For company lists, companies are removed from the list. Auth: X-API-Key

​
Path Parameters

  • id (integer, required): Lead list ID

​
Request Body (For People Lists)

{
  "prospect_ids": [12345, 12346, 12347]
}

​
Request Body (For Company Lists)

{
  "company_ids": [678, 679, 680]
}

​
Response (People List)

{
  "success": true,
  "deleted_count": 3,
  "search_type": "PEOPLE"
}

​
Response (Company List)

{
  "success": true,
  "deleted_count": 3,
  "search_type": "COMPANY"
}

​
Important Notes

  • People Lists: Prospects are archived (status changed to “ARCHIVED”) rather than permanently deleted. This preserves the data and allows you to restore them later if needed.
  • Company Lists: Companies are removed from the list entirely.
  • Only leads that belong to the specified list can be deleted.

​
Error Responses

​
400 Bad Request

{
  "error": "prospect_ids is required for people lists"
}

{
  "error": "company_ids is required for company lists"
}

​
404 Not Found

{
  "error": "Lead list not found"
}

​
Example Usage

# Delete prospects from a people list
curl -X DELETE "https://api.seleqt.ai/api/v1/public/lead-lists/123/delete-leads/" \
  -H "X-API-Key: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "prospect_ids": [12345, 12346, 12347]
  }'

# Delete companies from a company list
curl -X DELETE "https://api.seleqt.ai/api/v1/public/lead-lists/456/delete-leads/" \
  -H "X-API-Key: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "company_ids": [678, 679, 680]
  }'

import requests

# Delete specific prospects from a list
delete_response = requests.delete(
    "https://api.seleqt.ai/api/v1/public/lead-lists/123/delete-leads/",
    headers={"X-API-Key": "<your-api-key>"},
    json={"prospect_ids": [12345, 12346, 12347]}
)

result = delete_response.json()
print(f"Deleted {result['deleted_count']} prospects")

# Bulk delete based on filter criteria
# Step 1: Get leads with filters
get_response = requests.get(
    "https://api.seleqt.ai/api/v1/public/lead-lists/123/leads/",
    headers={"X-API-Key": "<your-api-key>"},
    params={"job_title": "Junior Developer"}  # Filter for leads to delete
)

# Step 2: Extract IDs
prospects_to_delete = get_response.json()["prospects"]
prospect_ids = [p["id"] for p in prospects_to_delete]

# Step 3: Delete them
if prospect_ids:
    delete_response = requests.delete(
        "https://api.seleqt.ai/api/v1/public/lead-lists/123/delete-leads/",
        headers={"X-API-Key": "<your-api-key>"},
        json={"prospect_ids": prospect_ids}
    )
    print(f"Deleted {delete_response.json()['deleted_count']} prospects")