---
search:
  tags:
    - Campaign Plans
    - GET
seo:
  description: >-
    Lists the Campaign Plans whose pool holds a Creative of… Reference for the
    GET /context/creatives/{creativeId}/campaign-plans endpoint in the AdCrunch
    API.
sidebar:
  label: List the Campaign Plans that use a Creative
  badge: GET
title: List the Campaign Plans that use a Creative
type: openapi-operation
---
Lists the Campaign Plans whose pool holds a Creative of the Library, newest first. A Campaign Plan holds a pool of Creatives of the Library, at most 50. Each Line Item of the plan picks its Creatives from the pool, at most 20. The ads of a Line Item are built from the Creatives of that Line Item only. A Creative of the pool that no Line Item uses is not assigned yet.

Each plan has its `slug` and `name`, and `lineItems`: the live Line Items of that plan that use the Creative, each with its `id` and `name`. An empty `lineItems` means that the plan holds the Creative in its pool and no Line Item uses it yet. A deleted plan and a deleted Line Item are not listed.

An unknown Creative, a deleted one and the Creative of another organization answer `404`, so this API does not confirm that an id exists somewhere else. This read gives no Variation and no Asset: they are in the Library, `GET /library/creatives/{creativeId}`.

One page at a time: `limit` rows at most, 100 by default. When the answer holds `nextCursor`, more rows exist: send it back as `cursor` to get the next page. A cursor of another Creative is refused.

`GET /context/creatives/{creativeId}/campaign-plans`

**Responses**

- `200` — One page of the Campaign Plans that use the Creative, newest first. This page is the last one, so it carries no \`nextCursor\`.
- `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 \`campaign\_plan:read\`. \`error\` is \`forbidden\`.
- `404` — No Creative with that id in the Library of this organization. \`error\` is \`not\_found\`.

Response example, 200:

```json
{
  "data": [
    {
      "id": "cpl_4b1d7e",
      "lineItems": [
        {
          "id": "lni_7f3a9c",
          "name": "Prospecting"
        },
        {
          "id": "lni_2c8e51",
          "name": null
        }
      ],
      "name": "Q4 Acquisition",
      "slug": "q4-acquisition"
    }
  ]
}
```
