---
title: "Max delivery and creative boost sessions on a GMV Max campaign"
method: GET
path: "/gmv-max/campaigns/{campaign_id}/sessions"
tags: ["GMV Max"]
---

# Max delivery and creative boost sessions on a GMV Max campaign

`GET /gmv-max/campaigns/{campaign_id}/sessions`

## Request

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

Read from TikTok on the request. Without `session_ids`: the campaign's active sessions (`campaign/gmv_max/session/list`). With `session_ids` (at most 20): those sessions, including ended ones (`session/get`). `managed_by_reacher` marks sessions a Reacher creative boost automation runs; change those through the automation. 404 if the campaign is not on this shop's store. Single shop only.

## Path parameters

- `campaign_id` string, required

## Query parameters

- `session_ids` string, nullable: Comma-separated session IDs, at most 20.

## Response `200`

Successful Response

- GmvMaxCampaignSessionsResponse: GET /gmv-max/campaigns/{campaign_id}/sessions — max delivery and creative boost sessions on a campaign.
  - `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
  - `campaign_id` string, required
  - `data` GmvMaxSession[], required
    - `session_id` string, required
    - `campaign_id` string, nullable
    - `bid_type` string, nullable: `NO_BID` is max delivery for a product; `CREATIVE_NO_BID` is a creative boost for a post.
    - `budget` number, nullable
    - `product_list` object[], nullable
    - `item_id` string, nullable
    - `schedule_type` string, nullable
    - `schedule_start_time` string, nullable
    - `schedule_end_time` string, nullable
    - `managed_by_reacher` boolean, required: True when a Reacher creative boost automation runs this session. Change it through that automation, not directly.
    - `reacher_automation_id` integer, nullable: The Reacher automation running this session.

## Other responses

- `400`: Invalid request / shop not connected to GMV Max.
- `403`: The shop's TikTok authorization lacks this permission.
- `404`: Campaign not found in this shop.
- `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/campaigns/:campaign_id/sessions/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)