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
nullwhen 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.
/context/campaign-plans/{slug}/line-items/{lineItemId}/readinessAuthorizationBearer token · headerrequiredSend Authorization: Bearer <credential>.
Use an API key (acr_…), from the AdCrunch console under Settings → API keys.
The credential names the organization, and no operation takes an organization parameter.
See https://docs.adcrunch.dev/api/authentication.
lineItemIdstringrequiredslugstringrequiredThe 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.
advertiserIdstringrequiredbudgetnumber | nullrequiredcurrencystringrequiredThe plan’s currency, confirmed equal to the account’s.
endDatestring | nullrequiredA calendar date, YYYY-MM-DD.
providerstringrequiredstartDatestring | nullrequiredA calendar date, YYYY-MM-DD.
statusstringrequiredreadyunitstringrequiredtotaldailystatusstringrequiredThe gate. Approving the plan, or validating the line, opens it.
not_validatedchannelstringrequiredmetatiktoksnapchatgoogle_searchgoogle_pmaxgoogle_displayyoutubeprogrammatic_displaylinkedinxproviderstring | nullrequiredWho sells it, when someone does but we cannot write there yet.
statusstringrequiredchannel_not_executablestatusstringrequiredno_advertiserstatusstringrequiredadvertiser_not_ownedactualstringrequiredexpectedstringrequiredstatusstringrequiredprovider_mismatchadvertiserIdstringrequiredstatusstringrequiredRefresh the provider connection.
account_currency_unknownaccountCurrencystringrequiredplanCurrencystringrequiredstatusstringrequiredNever converted. A converted budget is a different plan, and the planner allocated what they allocated.
currency_mismatchstatusstringrequiredno_windowendDatestringrequiredA calendar date, YYYY-MM-DD.
startDatestringrequiredA calendar date, YYYY-MM-DD.
statusstringrequiredwindow_invertedThe 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.
issuesobject[]requiredOne entry for each field that does not match.
Show propertiesHide properties
objectinstringrequiredThe part of the request that holds the field.
bodycookieheadersparamsquerymessagestringrequiredA sentence to show a person. Written to say what to do next. Reworded whenever it can be said better, so never branch on it.
pathstringrequiredA JSON Pointer into that part of the request, such as /filename. An empty string is the whole part.
errorstringrequiredA stable code for the failure. This is the field to branch on. It does not change for a given failure.
invalid_requestmessagestringrequiredA sentence to show a person. Written to say what to do next. Reworded whenever it can be said better, so never branch on it.
No API key, or one that does not resolve. See the security scheme. error is unauthorized.
errorstringrequiredA stable code for the failure. This is the field to branch on. It does not change for a given failure.
unauthorizedmessagestringrequiredA sentence to show a person. Written to say what to do next. Reworded whenever it can be said better, so never branch on it.
The caller does not hold campaign_plan:read. error is forbidden.
errorstringrequiredA stable code for the failure. This is the field to branch on. It does not change for a given failure.
forbiddenmessagestringrequiredA sentence to show a person. Written to say what to do next. Reworded whenever it can be said better, so never branch on it.
No such plan, or no Line Item with that id on it. error is not_found. This is the one readiness outcome that is not a 200, because the question itself has no subject.
errorstringrequiredA stable code for the failure. This is the field to branch on. It does not change for a given failure.
messagestringrequiredA sentence to show a person. Written to say what to do next. Reworded whenever it can be said better, so never branch on it.