---
title: "Retire an ID and schedule unreferenced data for deletion"
method: DELETE
path: "/lists/suppressions/{suppressionId}"
tags: ["Lists"]
---

# Retire an ID and schedule unreferenced data for deletion

`DELETE /lists/suppressions/{suppressionId}`

## Request

- Base URL: `https://api.wappalyzer.com/v2`
- URL: `https://api.wappalyzer.com/v2/lists/suppressions/{suppressionId}`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/wappalyzer/apis/wappalyzer-public-api/docs/lists/suppressions/:suppressionId/delete.ts> (a function with typed inputs; its response is checked against the schema)

Prevents new API list requests from using the ID. Existing lead lists and repeat jobs keep their immutable snapshot, which continues counting against storage. Cleanup waits at least 24 hours and retains data while referenced. Remove referencing lead lists to reclaim storage. Repeating deletion is safe while the metadata remains available; cleaned metadata expires after seven days.

## Response `200`

Retired or already-deleted suppression list.

- SuppressionList
  - `id` string, required
  - `name` string, required
  - `status` 'Pending' | 'Validating' | 'Ready' | 'Invalid' | 'Retired' | 'Deleted', required
  - `createdAt` integer, required: UNIX timestamp in seconds.
  - `domainCount` integer
  - `sizeBytes` integer: Validated snapshot size in bytes.
  - `error` string
  - `retiredAt` integer

## Other responses

- `403`: Authorization failed, the resource or method is invalid, or the account lacks sufficient credits.
- `404`: Unknown ID or ID owned by another account.
- `409`: Validation is in progress; retry after it completes.

---

[API](https://skmtc.dev/wappalyzer/apis/wappalyzer-public-api.md) - [All operations](https://skmtc.dev/wappalyzer/apis/wappalyzer-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wappalyzer/apis/wappalyzer-public-api/revisions/a67fcb00b7c5?raw)