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

# List GMV Max protected creators

`GET /gmv-max/protected-creators`

## Request

- Base URL: `https://api.reacherapp.com/public/v1`
- URL: `https://api.reacherapp.com/public/v1/gmv-max/protected-creators`
- Auth: API key in header `x-api-key` and API key in header `x-shop-id`

List the creators on this shop's GMV Max allow-list — creators the bottom-of-funnel auto-exclusion must never re-exclude. Newest first. `release_status` reports the one-time release of any already-excluded creatives back to spend. Single shop only.

## Response `200`

Successful Response

- GmvMaxProtectedCreatorsListResponse: GET /gmv-max/protected-creators — newest first.
  - `data` GmvMaxProtectedCreatorItem[], required
    - `handle` string, required: The creator's TikTok handle.
    - `source` string, required: How the creator was protected: `manual` or `import` (bulk).
    - `reason` string, nullable: Optional free-text note.
    - `release_status` string, required: State of the one-time release of already-excluded creatives: `pending` (queued), `released` (put back on spend), `failed` (the ADD-back was rejected, e.g. campaign at TikTok's exclusion cap), or `none` (nothing was excluded).
    - `released_video_count` integer: How many of the creator's creatives were released back to spend.
    - `decided_by` string, nullable: Who protected the creator (`api_key:<prefix>` for public writes).
    - `created_at` string, nullable: When the creator was protected (ISO 8601 UTC).
    - `updated_at` string, nullable: When the row was last touched (ISO 8601 UTC).

## Changes

> 76 revisions in range; 1 not diffed.

- **2026-09-29** `c8958a7038ec`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/reacherapp/apis/reacher-data-api/changes/gmv-max/protected-creators/get.md)

---

[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.dev/reacherapp/apis/reacher-data-api/revisions/63ce74b30b5a?raw)