Get Video Ads

GET 
/server/video-ads

Request a video ad each time a user visits a page on your platform where a video ad should appear.

Authentication: this endpoint does not authenticate via the Authorization header. The marketplace's API key (or, when allow_uuid_auth is enabled, its UUID) is delivered inside the encrypted payload query parameter; that token is what we check. See the payload parameter description below.

Request

Responses

200

Video ad found in VAST 4.2 format. Details can be found here.

204

No relevant video ads were found.

400

Bad Request — common causes:

• marketplace_id missing or marketplace not found (Invalid marketplace)
• payload missing/undecryptable/incomplete (missing placement_id or api_token)
• multi-region marketplace called without region_id (Region ID must be included for multi-region marketplaces)

403

Forbidden — api_token inside payload did not match the marketplace's API key (or UUID when allow_uuid_auth is enabled).

500

Internal Server Error