---
search:
  tags:
    - Line Items
    - GET
seo:
  description: >-
    Lists the Line Items of a Campaign Plan, newest first. Each row… Reference
    for the GET /context/campaign-plans/{slug}/line-items endpoint in the
    AdCrunch API.
sidebar:
  label: List the Line Items of a Campaign Plan
  badge: GET
title: List the Line Items of a Campaign Plan
type: openapi-operation
---
Lists the Line Items of a Campaign Plan, newest first. Each row is a Line Item with the provider objects it created, in `executions`.

A row carries no `readiness`. To learn whether AdCrunch can build a Line Item now, read that Line Item with `GET /campaign-plans/{slug}/line-items/{lineItemId}`.

The read of the Campaign Plan gives the number of Line Items in `lineItemCount`, and it does not list them.

One page at a time: `limit` Line Items at most, 100 by default. When the answer holds `nextCursor`, more Line Items exist: send it back as `cursor` to get the next page.

The MCP tool `line_item_list` gives the same answer to an agent.

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

**Responses**

- `200` — One page of the Line Items of the Campaign Plan, 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 Campaign Plan with that slug. \`error\` is \`not\_found\`.

Response example, 200:

```json
{
  "data": [
    {
      "advertiserId": "acc_1203456789012345",
      "ageMax": 44,
      "ageMin": 25,
      "budget": 2500,
      "campaignPlanId": "cpl_4e1a08",
      "channel": "meta",
      "countries": [
        "FR",
        "BE"
      ],
      "createdAt": 1768435200000,
      "createdBy": "usr_5d2b71",
      "effectiveEndDate": "2026-05-31",
      "effectiveStartDate": "2026-03-01",
      "endDate": null,
      "executable": true,
      "executions": [
        {
          "advertiserId": "acc_1203456789012345",
          "createdAt": 1772409600000,
          "entityId": "120210000000000",
          "entityType": "campaign",
          "id": "exe_7a4c12",
          "mutationId": "mut_k3x9q2v7m4n8p1r5t6w0y2z4",
          "provider": "meta"
        }
      ],
      "gender": "all",
      "id": "lni_2d9e77",
      "name": "Spring reach, France and Belgium",
      "objective": "sales",
      "personaId": "psn_8c4a20",
      "provider": "meta",
      "revision": 2,
      "startDate": null,
      "status": "validated",
      "targetMetric": "cpa",
      "targetValue": 24.5,
      "unit": "total",
      "updatedAt": 1769040000000
    }
  ]
}
```
