---
title: "Read gift status for one campaign"
method: GET
path: "/campaigns/{id}/tracking"
tags: ["Tracking & events"]
---

# Read gift status for one campaign

`GET /campaigns/{id}/tracking`

## Request

- Base URL: `https://gtmswag.com/api/v1`
- URL: `https://gtmswag.com/api/v1/campaigns/{id}/tracking`
- Auth: HTTP bearer

Same as `GET /tracking` with `campaignId` set from the path.

## Path parameters

- `id` string, required

## Query parameters

- `externalId` string
- `status` 'awaiting_address' | 'queued' | 'in_production' | 'shipped' | 'delivered' | 'cancelled'
- `sendId` string
- `limit` integer
- `cursor` string

## Response `200`

Success: `{"data": TrackingPage}`.

- TrackingPageResponse: The success body: `{"data": TrackingPage}`.
  - `data` TrackingPage, required: One page of the gift status snapshot; `nextCursor` is null on the last page. Not a change feed.
    - `items` Tracking[], required
      - `sendId` string, required
      - `campaignId` string, nullable, required
      - `status` 'awaiting_address' | 'queued' | 'in_production' | 'shipped' | 'delivered' | 'cancelled', required
      - `outcome` 'none' | 'replied' | 'meeting_booked' | 'meeting_held', required
      - `mode` 'test' | 'live', required
    - `nextCursor` string, nullable, required

## Other responses

- `400`: Bad request: `VALIDATION_ERROR`, `INVALID_REQUEST`. Each example says when.
- `401`: Not authenticated: `AUTH_REQUIRED`. no credentials, or an OAuth token on a route that only takes workspace keys; the key is malformed, unknown or revoked.
- `404`: Not found: `NOT_FOUND`. Each example says when.
- `429`: Too many requests: `RATE_LIMIT`. more than 240 requests in the current minute for this workspace (REST and MCP share the limit); wait `retryAfterMs`.
- `default`: Any other refusal or failure, such as 403 CSRF (a cross-origin `Origin` header), 403 HTTPS_REQUIRED or 500 INTERNAL_ERROR, with what to do next.

---

[API](https://skmtc.dev/gtmswag/apis/gtm-swag-api.md) · [All operations](https://skmtc.dev/gtmswag/apis/gtm-swag-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gtmswag/apis/gtm-swag-api/revisions/9ff86fa99afe?raw)