Skip to content
Smartcast Media API

Planning and availability

Check before you commit. Choose screens of one placing, INDOOR or OUTDOOR (GET /v1/screens?placing=OUTDOOR): a plan or campaign that mixes them is refused with MIXED_PLACING, or MIXED_PROVIDER when one placing is sold by several providers.

Neither call below reserves anything: capacity is taken only when a campaign is approved.

Availability

Section titled “Availability”

POST /v1/screens/availability says whether an ad of a given length fits on every day of a range. fullDays lists the days that do not.

Plans

Section titled “Plans”

POST /v1/campaign-plans returns per-screen cost and what you need to upload.

  • totals has one entry per currency.
  • complete is false when some screens have no price. totals leaves those out.
  • A screen with available: false has a reason in unavailableReason.
  • contentRequirements lists the videos needed. Upload them into the campaign once it is created.

Prices can change until the campaign is submitted, when they are stored on it.

Between planning and approval, another campaign can take the last room on a screen. In that case submission or booking reports NO_CAPACITY with the screens and days affected.