> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apostra.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get tracked-campaign subscription

> Inspect metadata mirror freshness and the fixed history boundary

Returns the durable account subscription created by
`subscribe_directed_campaigns`.

**Named operation:** `get_directed_campaign_subscription`

| Field          | Location | Type    | Required | Description                 |
| -------------- | -------- | ------- | -------- | --------------------------- |
| `connectionId` | path     | integer | Yes      | Adapter connection ID       |
| `accountId`    | path     | integer | Yes      | Connected ad-account row ID |

Use `lastSyncedAt`, `lastSyncStatus`, and `lastSyncError` to show mirror
health. When the latest sweep failed, `errorCode`, `errorField`, `errorReason`,
and `upstreamCode` provide the available safe machine-readable diagnosis. A
successful later sweep clears all four diagnostic fields to `null`.
`backfillStart` is the fixed one-year metadata boundary set when the account
was subscribed. It does not indicate that delivery reports were imported, nor
is it a running progress indicator: delivery remains live read-through.

`lastPresenceSyncedAt`, `lastPresenceSyncStatus`, and `lastPresenceSyncError`
are the cursor of the separate tracked-presence sweep, which discovers
audiences and event sources (pixels) on the subscribed account. All three are
`null` until that sweep first visits the subscription. `SKIPPED` means the
sweep visited but presence discovery did not apply — for example, the
connection does not use a registered adapter provider. A `SUCCESS` with an empty
[presence list](/v2/buyer/storefronts/tasks/list-account-presences)
means the account genuinely has no discoverable audiences or event sources.

## Response

```json theme={null}
{
  "id": "17",
  "customerId": 100,
  "advertiserId": "12345",
  "connectionId": "42",
  "accountId": "81",
  "sourceId": "tiktok",
  "providerType": "tiktok",
  "status": "ACTIVE",
  "backfillStart": "2025-07-12T10:00:00.000Z",
  "lastSyncedAt": "2026-07-12T10:15:03.000Z",
  "lastSyncStatus": "SUCCESS",
  "lastSyncError": null,
  "errorCode": null,
  "errorField": null,
  "errorReason": null,
  "upstreamCode": null,
  "lastPresenceSyncedAt": "2026-07-12T10:20:41.000Z",
  "lastPresenceSyncStatus": "SUCCESS",
  "lastPresenceSyncError": null,
  "createdAt": "2026-07-12T10:00:00.000Z",
  "updatedAt": "2026-07-12T10:15:03.000Z",
  "archivedAt": null
}
```

`status` is the subscription lifecycle (`ACTIVE`, `PAUSED`, or `ERROR`).
`lastSyncStatus` is the outcome of the latest metadata reconciliation. If it is
`ERROR`, `lastSyncedAt` is the time of that failed attempt; show it together with
`lastSyncError` and any non-null machine-readable diagnostic fields. The
previous valid mirrors are retained. A `NOT_FOUND` response means this
connection/account has never been subscribed or is outside the authenticated
customer and advertiser scope.

See [Campaigns on connected provider accounts](/v2/buyer/campaigns/directed-campaigns).