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

# List GMV Max campaigns

`GET /gmv-max/campaigns`

List all GMV Max (TikTok Smart+) campaigns for the shop(s) addressed by `x-shop-id`. Returns cached campaign metadata last synced from TikTok by the portal — call the portal's sync endpoints to refresh. Supports multi-shop (`x-shop-id: all` or comma-separated).

## Response `200`

Successful Response

- GmvMaxCampaignsResponse
  - `data` GmvMaxCampaignItem[], required
    - `shop_id` integer, required
    - `campaign_id` string, required
    - `campaign_name` string, nullable
    - `status` string, nullable
    - `shopping_ads_type` string, nullable — GMV Max objective / ads type.
    - `budget` number, nullable
    - `roas_bid` number, nullable — Target ROAS bid set on the campaign.
    - `last_synced_at` string, nullable — ISO 8601 UTC of the most recent TikTok sync.
    - `currency` string, nullable — ISO currency code for the shop's region.
  - `shops_queried` string[], nullable — Shop names included when querying multiple shops (x-shop-id: all or comma-separated).

---

[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/643422c93bd8/schema)