---
search:
  tags:
    - Campaigns
    - GET
seo:
  description: >-
    Available on: Meta TikTok Google Ads OpenAI. Reference for the GET
    /observe/{advertiserId}/campaigns endpoint in the AdCrunch API.
sidebar:
  label: List an advertiser’s campaigns
  badge: GET
title: List an advertiser’s campaigns
type: openapi-operation
---
**Available on:** [![Meta](/providers/meta.svg)](https://docs.adcrunch.dev/connect/providers) [![TikTok](/providers/tiktok.svg)](https://docs.adcrunch.dev/connect/providers) [![Google Ads](/providers/gads.svg)](https://docs.adcrunch.dev/connect/providers) [![OpenAI](/providers/openai.svg)](https://docs.adcrunch.dev/connect/providers)

Live read. Asks the provider for the campaigns of one ad account, now. The path names the advertiser, so the answer is what the provider holds, not what AdCrunch holds.

An advertiser that your organization does not own answers `404`, with `error` of `not_found`. An advertiser that does not exist answers the same. The answer does not tell the two apart.

A live row carries no `createdAt`, `updatedAt` or `deletedAt`, because AdCrunch stores nothing for it. Each request counts against the rate limits of the provider.

For the stored rows of the same advertiser, read `/observe/campaigns?advertiserId=…`. That path takes every `status`, and the Status section below lists the statuses this one takes.

`limit` and `cursor` page the answer. Send `nextCursor` back as `cursor` to get the next page. A live cursor is good only for a live read. At TikTok, every page keeps the page size of the first.

### Status

`status` selects the status an entity is set to, not whether it delivers, and every row of the answer carries it. A provider takes a status only where one request to it selects exactly the entities in that status. Any other status answers `501`.

The stored read, `/observe/campaigns?advertiserId=…&status=…`, takes every status. A status that a provider never uses answers an empty list.

| Provider | Takes `status` |
| --- | --- |
| Meta | none yet |
| TikTok | `DELETED`, `ARCHIVED` |
| Google Ads | `ACTIVE`, `PAUSED`, `DELETED`, `ARCHIVED` |
| OpenAI | `DELETED` |

`GET /observe/{advertiserId}/campaigns`

**Responses**

- `200` — The matching campaigns of this advertiser.
- `400` — The request does not match the schema of this operation: a field is missing or has the wrong type, or the body is not valid JSON. \`error\` is \`invalid\_request\`, and \`issues\` names each field. Nothing was changed. Or AdCrunch cannot use the \`cursor\`: it cannot read it, or the cursor belongs to a different query. Then \`error\` is \`invalid\_cursor\`. Send the \`nextCursor\` of the previous page with no change, or omit \`cursor\` to get the first page.
- `401` — No API key, or one that does not resolve. See the security scheme. \`error\` is \`unauthorized\`.
- `402` — The organization has no active subscription. An owner subscribes at \`paywallUrl\`. \`error\` is \`organization\_unentitled\`.
- `403` — The caller does not hold \`observe:read\`. \`error\` is \`forbidden\`.
- `404` — Your organization does not own the advertiser in the path, or it does not exist. The answer does not tell the two apart. \`error\` is \`not\_found\`. AdCrunch asks the provider nothing.
- `409` — This advertiser has no usable connection to its provider. A person must reconnect it. The stored read of the same resource, with \`advertiserId\`, still answers what AdCrunch holds.
- `501` — AdCrunch cannot read this resource live from this advertiser’s provider. It is permanent. Read the stored copy instead, at the same resource without the advertiser in the path and with \`advertiserId\`.
- `502` — The provider refused the request, or could not answer it. This failure is often transient. Send the request again.

Response example, 200:

```json
{
  "data": [
    {
      "adsetBudgetSharing": null,
      "advertiserId": "acc_1203456789012345",
      "bidStrategy": null,
      "budget": 250,
      "budgetLevel": "campaign",
      "budgetType": "daily",
      "createdAt": null,
      "createdTime": 1789600000000,
      "currency": "EUR",
      "deletedAt": null,
      "id": "120210000000000",
      "name": "Spring sale — prospecting",
      "objective": "OUTCOME_SALES",
      "path": "120210000000000",
      "provider": "meta",
      "status": "ACTIVE",
      "type": "campaign",
      "updatedAt": null,
      "updatedTime": 1789900000000
    }
  ],
  "nextCursor": "eyJwIjp7ImFmdGVyIjoiUVZGSVVteFpBVmhSUTJ0QlVXdFIiLCJwcm92aWRlciI6Im1ldGEifSwicSI6IjF6ZnVpaHR5aGJiIiwibCI6dHJ1ZX0"
}
```
