---
title: "List GMV Max excluded creators"
method: GET
path: "/gmv-max/excluded-creators"
tags: ["GMV Max"]
---

# List GMV Max excluded creators

`GET /gmv-max/excluded-creators`

List the creators excluded from this shop's GMV Max bottom-of-funnel delivery — both manually excluded (`source: manual`) and auto-detected (`source: auto_bof`). Ordered applied first, then pending, then failed; newest first within each status. Single shop only (set `x-shop-id` to a specific shop ID).

## Response `200`

Successful Response

- GmvMaxExcludedCreatorsListResponse — GET /gmv-max/excluded-creators — applied first, then pending, then failed; newest first within each status.
  - `data` GmvMaxExcludedCreatorItem[], required
    - `handle` string, required — The creator's TikTok handle.
    - `source` string, required — How the exclusion was created: `manual` (via POST /gmv-max/excluded-creators or the portal) or `auto_bof` (the reconcile job's automatic bottom-of-funnel detection).
    - `reason` string, nullable — Why the creator was flagged (populated for `auto_bof` rows).
    - `bof_confidence` integer, nullable — Auto-detection confidence 0–100 (populated for `auto_bof` rows).
    - `excluded_video_count` integer — How many of the creator's videos this exclusion covers.
    - `applied_status` string, required — Whether the exclusion has taken effect on spend: `applied` (live), `pending` (armed, reconcile job hasn't run yet), or `failed`.
    - `decided_by` string, nullable — Who created the exclusion. For public-API writes this is the calling API key's identity (`api_key:<prefix>`).
    - `created_at` string, date-time, nullable — When the exclusion row was first created.
    - `updated_at` string, date-time, nullable — When the reconcile job last touched this row.

---

[API](https://skmtc.dev/reacherapp/apis/reacher-data-api.md) · [All operations](https://skmtc.dev/reacherapp/apis/reacher-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/reacherapp/reacher-data-api/revisions/3ea20a9f734b/schema)