# List exclusion lists

Returns all exclusion lists available to your team, each scoped to a single platform. This includes both the auto-created default list per platform and any specific lists you have created. Adding handles to a list does not filter search on its own — apply a list to a search by passing exclude_list (list IDs), exclude_default_list, or exclude_all_lists in the Discovery or Similar Creators filters.

Endpoint: GET /public/v1/discovery/exclusion-lists/
Version: 1.0.0
Security: Bearer

## Response 200 fields (application/json):

  - `id` (integer, required)
    The exclusion list's unique identifier.
    Example: 42

  - `name` (string, required)
    Human-readable name of the exclusion list.
    Example: "Blocklist Q4"

  - `platform` (string, required)
    The social media platform this list applies to.
    Example: "instagram"

  - `is_default` (boolean, required)
    Whether this is the team's default list for the platform.

  - `handle_count` (integer, required)
    Number of handles currently in the list.
    Example: 3

  - `created_at` (string, required)
    When the list was created.
    Example: "2026-01-15T09:30:00Z"

  - `updated_at` (string, required)
    When the list was last modified.
    Example: "2026-01-20T14:05:00Z"


## Response 400 fields

## Response 401 fields

## Response 422 fields