Line Items

Check a Line Item’s execution readiness

Tells you whether AdCrunch can execute a Line Item now, and if it cannot, why. Ask this before any provider call.

This call reads. It changes nothing, and it calls no provider. It answers for every channel, including a channel AdCrunch cannot write to.

A line is not ready in these conditions:

  • Nobody validated the line.
  • 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 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 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.

When the line is ready, the answer also gives the resolved window, and it tells you whether the budget goes to the provider as a lifetime total or as a daily rate.

get/context/campaign-plans/{slug}/line-items/{lineItemId}/readiness

Request

  • Base URL: https://api.adcrunch.dev
  • URL: https://api.adcrunch.dev/context/campaign-plans/{slug}/line-items/{lineItemId}/readiness
  • Auth: HTTP bearer

Path parameters

lineItemIdstring required
slugstring required

Response

The verdict, discriminated on status. Every outcome is a 200, ready included: "this cannot run, and here is why" is an answer rather than a failed request. The example shows ready; the schema lists the nine refusals and what each one carries.

OR
OR
OR
OR
OR
OR
OR
OR
OR

Changes

No recorded changes to this operation across all 1 revision of this API.