Introduction

The Verve Retail Media platform lets you serve ads to retail (DOOH) screens and manage the physical inventory those screens belong to. Integration happens over two REST APIs.

The APIs

API	Auth	What it does
Ad API	Public	Request ads for a player, report playback exposure, and send signals.
Inventory API	OAuth 2.0	Register and update locations and devices via idempotent upsert endpoints.

Authentication at a glance

• The Ad API is public — no access token, no namespace header. The only identifiers are the key + playerid carried on the request itself.
• The Inventory API is protected — every call needs an OAuth 2.0 access token and the X-Verve-Namespace project header.

See Authentication for the full flow.

Endpoints

You will receive one set of endpoints per environment at onboarding.