---
search:
  tags:
    - Stored reads
    - GET
seo:
  description: >-
    Available on: Meta TikTok Google Ads OpenAI. Reference for the GET
    /observe/campaigns endpoint in the AdCrunch API.
sidebar:
  label: List campaigns
  badge: GET
title: List 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)

Stored read. Lists the campaigns of every ad account your organization connects, across the providers, newest first.

A campaign is a `campaign` at every provider, so this reads them all in one call. Send `provider` to read one platform.

### Paging

`limit` counts rows of the answer itself, not rows of each advertiser, so a `limit` of 10 answers at most 10 rows however many advertisers you own. When the answer holds `nextCursor`, more rows exist: send it back as `cursor` to get the next page. The row that AdCrunch stored last comes first, so a campaign that arrives while you page does not move a page you already read.

### Where a campaign comes from

It answers what AdCrunch holds, which its ingestion refreshes. A campaign a person changed in the provider’s own interface a moment ago may not be here yet — name one advertiser in the path, `/observe/{advertiserId}/campaigns`, to read the provider itself.

### Budget and objective

Every row carries its `budget`, in **whole units** of its `currency` — the unit of `spend` on an Insight — with `budgetType` and `budgetLevel`. `budgetLevel` says whether the budget lives on the campaign or on its ad groups; when it is `ad_group`, read `/observe/ad-groups` for the amounts. `objective` is the provider’s own word, and it is null on a Google Ads campaign, which has none.

A row carries the fields AdCrunch normalizes. For the provider’s own payload, read one campaign by id.

`GET /observe/campaigns`

**Responses**

- `200` — The matching campaigns, and how many there are in all.
- `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\`.

Response example, 200:

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