---
search:
  tags:
    - Campaigns
    - GET
seo:
  description: >-
    Available on: Meta TikTok Google Ads OpenAI. Reference for the GET
    /observe/{advertiserId}/campaigns/{id} endpoint in the AdCrunch API.
sidebar:
  label: Get one campaign
  badge: GET
title: Get one campaign
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 one campaign now, and gives its payload with the field names of the provider. This is the escape hatch from the normalized fields.

The keys are the provider’s. A Meta campaign answers `id`, `name`, `objective`, `daily_budget`, `lifetime_budget`, `bid_strategy` and `is_adset_budget_sharing_enabled`; a TikTok campaign answers `campaign_id`, `campaign_name`, `objective_type`, `budget_mode` and `budget_optimize_on`; a Google Ads campaign answers `id`, `name`, `status`, `budgetAmountMicros` and `budgetTotalAmountMicros`.

**The payload holds the fields AdCrunch asks the provider for, and no more.** It is not everything the provider knows about the campaign: a bid strategy, a spending limit and a schedule are outside the set AdCrunch reads, so they are in no payload here.

### Money

AdCrunch changes one thing in the payload: the money of Meta, `daily_budget` and `lifetime_budget`. Meta writes each amount in a unit that depends on the currency. This read gives each one as a number in **whole units** of the currency of the advertiser. It is the unit of `budget` on a row: `250` is 250.00. When AdCrunch does not know the currency of the advertiser, each of these fields is `null`.

A TikTok amount is in whole units already, so it does not change. A Google Ads field whose name ends in `Micros` states its unit, so it stays in micros: `12340000` is 12.34.

### When there is nothing to give

**`404`** — the provider holds no such campaign on this ad account, the provider has no campaign at all, or your organization does not own the advertiser in the path. They are deliberately not told apart: distinguishing them would confirm that a campaign exists to somebody who cannot read it.

`GET /observe/{advertiserId}/campaigns/{id}`

**Responses**

- `200` — The payload the provider holds now, with the money of Meta in whole units.
- `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.
- `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` — The provider holds no such entity on this ad account, the provider does not have this kind of entity, or your organization does not own the advertiser in the path. They are deliberately not told apart. \`error\` is \`not\_found\`.
- `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
{
  "account_id": "1203456789012345",
  "bid_strategy": "COST_CAP",
  "created_time": "2026-09-16T23:06:40+0000",
  "daily_budget": 250,
  "id": "120210000000000",
  "is_adset_budget_sharing_enabled": false,
  "lifetime_budget": 0,
  "name": "Spring sale — prospecting",
  "objective": "OUTCOME_SALES",
  "start_time": "2026-09-17T00:00:00+0000",
  "status": "ACTIVE",
  "updated_time": "2026-09-20T10:26:40+0000"
}
```
