---
title: "List account suppression IDs, statuses and storage allocation"
method: GET
path: "/lists/suppressions"
tags: ["Lists"]
---

# List account suppression IDs, statuses and storage allocation

`GET /lists/suppressions`

## Request

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

## Query parameters

- `cursor` string

## Response `200`

Suppression lists and account storage allocation.

- SuppressionListPage
  - `lists` SuppressionList[], required
    - `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
  - `nextCursor` string, nullable, required
  - `allocatedBytes` integer, required: Validated file storage, including snapshots retained for existing lead lists.
  - `limits` object, required
    - `fileBytes` unknown
    - `domains` unknown
    - `accountBytes` unknown
    - `uploadsPerDay` unknown
    - `pendingUploads` unknown
    - `uploadSeconds` unknown
    - `activeUploadSeconds` unknown
    - `abandonedSeconds` unknown

## Other responses

- `400`: The request payload or query string was invalid.
- `403`: Authorization failed, the resource or method is invalid, or the account lacks sufficient credits.

---

[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)