---
title: "This shop's TikTok Shop as GMV Max sees it"
method: GET
path: "/gmv-max/store"
tags: ["GMV Max"]
---

# This shop's TikTok Shop as GMV Max sees it

`GET /gmv-max/store`

## Request

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

Read from TikTok's `gmv_max/store/list` on the request: whether this shop's store is available for GMV Max, its status, its Business Center, and which ad account holds its GMV Max exclusive authorization. Other stores the ad account can reach are never returned. 404 if the ad account can no longer reach this store. Single shop only.

## Response `200`

Successful Response

- GmvMaxStoreResponse: GET /gmv-max/store — this shop's TikTok Shop as GMV Max sees it.
  - `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` GmvMaxStore, required
    - `store_id` string, required
    - `store_name` string, nullable
    - `is_gmv_max_available` boolean, nullable: Whether GMV Max campaigns can run on this store.
    - `store_status` string, nullable: ACTIVE, INACTIVE, NEW_CREATE.
    - `store_authorized_bc_id` string, nullable
    - `exclusive_authorized_advertiser_info` object, nullable: The one ad account allowed to run GMV Max for this store.

## Other responses

- `400`: Invalid request / shop not connected to GMV Max.
- `403`: The shop's TikTok authorization lacks this permission.
- `404`: Store not reachable.
- `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/store/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)