---
search:
  tags:
    - Line Items
    - GET
seo:
  description: >-
    Reads one Line Item with its readiness: whether… Reference for the GET
    /context/campaign-plans/{slug}/line-items/{lineItemId} endpoint in the
    AdCrunch API.
sidebar:
  label: Get a Line Item
  badge: GET
title: Get a Line Item
type: openapi-operation
---
Reads one Line Item with its `readiness`: whether AdCrunch can build it now, and if not, why. Ask this **before** any provider call.

This is the one read that carries the readiness. The list of Line Items and the writes of a Line Item return the Line Item without it. The read of a Campaign Plan returns no Line Item. This call reads. It changes nothing, and it calls no provider. It answers for every channel, including a channel AdCrunch cannot write to.

The answer is the Line Item, with the same fields as a row of the list of the Line Items of its Campaign Plan, and two more fields: `currency` and `readiness`. `currency` is the currency of the Campaign Plan. Each amount of the Line Item is in whole units of that currency. `status` is the status of the Line Item. `readiness.status` is the verdict.

A Line Item is not ready in these conditions:

- A person has not validated the Line Item in the AdCrunch console. The validation is a record: the provider write tools do not check it.
- AdCrunch cannot write to the channel. The answer names the provider that sells it, or `null` when nobody we integrate with sells it.
- The Line Item has no ad account.
- The ad account is not connected to this organization.
- The ad account belongs to a different provider than the channel.
- The currency of the ad account is different from the Campaign Plan currency, or AdCrunch does not know that currency yet. To make it known, refresh the provider connection.
- The Line Item and the Campaign Plan give no date at all.
- The resolved start follows the resolved end. Each row is ordered on its own, and only the pair shows this.

AdCrunch never converts a currency. A converted budget is a different plan.

The verdict is advice. The provider write tools do not read it.

When the Line Item is `ready`, the verdict also gives the dates that apply, and it tells you whether the budget goes to the provider as a lifetime total or as a daily rate.

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

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

**Responses**

- `200` — The Line Item, its readiness and the currency of its Campaign Plan. \*\*Every readiness outcome is a 200\*\*, \`ready\` included. The example shows \`ready\`; the schema lists the nine refusals and what each one carries.
- `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 such Campaign Plan, or no Line Item with that id on it. \`error\` is \`not\_found\`.

Response example, 200:

```json
{
  "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": [],
  "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,
  "currency": "EUR",
  "readiness": {
    "advertiserId": "acc_1203456789012345",
    "budget": 2500,
    "currency": "EUR",
    "endDate": "2026-05-31",
    "provider": "meta",
    "startDate": "2026-03-01",
    "status": "ready",
    "unit": "total"
  }
}
```
