---
title: "GMV Max creative delivery-status breakdown"
method: GET
path: "/gmv-max/campaigns/{campaign_id}/delivery-status"
tags: ["GMV Max"]
---

# GMV Max creative delivery-status breakdown

`GET /gmv-max/campaigns/{campaign_id}/delivery-status`

## Request

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

Creative counts and spend for one campaign grouped by delivery status, computed from each creative's LATEST daily metric row. Statuses are bucketed from TikTok's raw `creative_delivery_status` into a canonical set (`delivering`, `not_delivering`, `in_review`, `rejected`, `inactive`, `unknown`); NULL or unrecognised statuses bucket as `unknown`. Sorted by spend descending. Empty `data` is a normal 200. Single shop only.

## Path parameters

- `campaign_id` string, required

## Response `200`

Successful Response

- GmvMaxCampaignDeliveryStatusResponse: GET /gmv-max/campaigns/{id}/delivery-status — sorted by spend descending.
  - `campaign_id` string, required
  - `shop_id` integer, required
  - `data` GmvMaxDeliveryStatusItem[], required
    - `status` 'delivering' | 'not_delivering' | 'in_review' | 'rejected' | 'inactive' | 'unknown', required: Canonical delivery status, bucketed from TikTok's raw `creative_delivery_status`. NULL / unrecognised → `unknown`.
    - `creative_count` integer, required: Distinct creatives whose latest daily row carries this status.
    - `spend` number, required: Total ad spend across those creatives' latest daily rows.
  - `currency` string, required: ISO currency code for the shop's region.

## Other responses

- `422`: Validation Error

## Changes

> 76 revisions in range; 1 not diffed.

- **2026-09-02** `d4fe3e380424`: 1 info
  - endpoint added

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