---
title: "Does this ad account hold the store's GMV Max exclusive authorization"
method: GET
path: "/gmv-max/exclusive-authorization"
tags: ["GMV Max"]
---

# Does this ad account hold the store's GMV Max exclusive authorization

`GET /gmv-max/exclusive-authorization`

## Request

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

TikTok's `gmv_max/exclusive_authorization/get`, read on the request. Only one ad account can run GMV Max for a store; `authorization_status` says whether it is this shop's. Single shop only.

## Response `200`

Successful Response

- GmvMaxExclusiveAuthorizationResponse: GET /gmv-max/exclusive-authorization — whether this ad account holds the store's GMV Max exclusive authorization.
  - `shop_id` integer, required
  - `advertiser_id` string, required
  - `store_id` string, required: This shop's TikTok Shop (store) ID.
  - `source` 'live': Always `live`: read from TikTok on the request.
  - `fetched_at` string, nullable, required
  - `data` object, required: TikTok's answer: `authorization_status`, `advertiser_id`, `advertiser_name`, `advertiser_status`, `identity_id`.

## Other responses

- `400`: Invalid request / shop not connected to GMV Max.
- `403`: The shop's TikTok authorization lacks this permission.
- `422`: TikTok rejected the request.
- `429`: TikTok is throttling, or the live-read cap was reached.
- `502`: TikTok failed transiently; safe to retry.
- `503`: Live reads are briefly unavailable; retry in a minute.

## Changes

> 76 revisions in range; 1 not diffed.

- **2026-10-18** `17e0890869d5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/reacherapp/apis/reacher-data-api/changes/gmv-max/exclusive-authorization/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)