---
title: "List exclusion lists"
method: GET
path: "/public/v1/discovery/exclusion-lists/"
tags: ["Exclusion lists"]
---

# List exclusion lists

`GET /public/v1/discovery/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`.

## Response `200`

- ExclusionList[]
  - `id` integer, required — The exclusion list's unique identifier.
  - `name` string, required — Human-readable name of the exclusion list.
  - `platform` string, required — The social media platform this list applies to.
  - `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.
  - `created_at` string, date-time, required — When the list was created.
  - `updated_at` string, date-time, required — When the list was last modified.

## Other responses

- `400` — Bad request — invalid or missing parameters.
- `401` — Unauthorized — missing or invalid API key.
- `422` — Unprocessable entity — validation failed.

---

[API](https://skmtc.net/influencers/apis/core-api-concepts.md) · [All operations](https://skmtc.net/influencers/apis/core-api-concepts/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/influencers/core-api-concepts/versions/cd6c016f2cd6/schema)