---
search:
  tags:
    - Campaign Plans
    - GET
seo:
  description: >-
    Reads one Campaign Plan. The answer gives the number of its Line Items in…
    Reference for the GET /context/campaign-plans/{slug} endpoint in the
    AdCrunch API.
sidebar:
  label: Get a Campaign Plan
  badge: GET
title: Get a Campaign Plan
type: openapi-operation
---
Reads one Campaign Plan. The answer gives the number of its Line Items in `lineItemCount`, and it does not list them.

To list the Line Items with the provider objects each one created, use `GET /campaign-plans/{slug}/line-items`. To learn whether AdCrunch can build one Line Item now, read that Line Item with `GET /campaign-plans/{slug}/line-items/{lineItemId}`: only that read carries the `readiness`.

The plan has the three money figures. If `allocation.comparable` is `false`, the lines do not share one unit. Show "not comparable" in that condition. Do not show a total.

Send `revision` back as `base_revision` when you write to the Campaign Plan.

`GET /context/campaign-plans/{slug}`

**Responses**

- `200` — The Campaign Plan, with \`lineItemCount\` and without its Line Items.
- `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 \`campaign\_plan:read\`. \`error\` is \`forbidden\`.
- `404` — No Campaign Plan with that slug. \`error\` is \`not\_found\`.

Response example, 200:

```json
{
  "allocation": {
    "allocated": 2500,
    "comparable": true,
    "unallocated": 2500,
    "unit": "total"
  },
  "assignees": [
    {
      "id": "usr_4d8b12",
      "name": "Maya Lindqvist"
    }
  ],
  "body": "## Why this split\n\nMeta carries the reach. One Line Item keeps the budget in one place.\n\n## How it will be judged\n\nRevenue in the window, against the spring of 2025.",
  "brand": {
    "name": "Acme",
    "slug": "acme"
  },
  "brandId": "brd_6a9c33",
  "commentCount": 2,
  "createdAt": 1768435200000,
  "createdBy": "usr_5d2b71",
  "currency": "EUR",
  "description": "The spring sale of Acme, on Meta, in France and Belgium.",
  "endDate": "2026-05-31",
  "id": "cpl_4e1a08",
  "lineItemCount": 1,
  "name": "Spring Sale 2026",
  "revision": 3,
  "slug": "spring-sale",
  "startDate": "2026-03-01",
  "status": "approved",
  "totalBudget": 5000,
  "updatedAt": 1769040000000
}
```
