OpenAPI Specification

The main LtvAdx endpoints — ad serving, OpenRTB, Identity, campaigns, inventory, deals and reporting — with a downloadable OpenAPI 3.1 file.

Download openapi.yaml Developer Hub Documentation

Your ad server base URL and API credentials are available in Dashboard → Settings → API credentials after signing in. Contact our team to request access.

Ad Servinghttps://ads.ltvadx.com

GET/vastVAST 4.2 ad for one break (channelId, householdId, platform, breakType, duration)

GET/vmapVMAP 1.0.1 playlist: pre-roll, one mid-roll, post-roll

GET/track/{requestId}Tracking beacon — event=impression | start | firstQuartile | midpoint | thirdQuartile | complete | skip | click | error …

POST/ssai/sessionsCreate an SSAI session (skeleton — not for live traffic)

GET/ssai/hls/{sessionId}/manifest.m3u8Session HLS manifest (fixed template today)

GET/ssai/dash/{sessionId}/manifest.mpdSession DASH manifest (fixed template today)

GET/ssai/sessions/{sessionId}Session status

OpenRTBhttps://ads.ltvadx.com

POST/rtb/bidInbound OpenRTB 2.6 bid request (X-Rtb-Api-Key) — 200 bid or 204 no bid

POST/api/v1/rtb/exchangesCreate a seat (admin) — key returned once

GET/api/v1/rtb/exchangesList seats (admin)

PATCH/api/v1/rtb/exchanges/{id}/toggleSwitch a seat on or off (admin)

POST/api/v1/rtb/exchanges/{id}/rotate-keyIssue a new seat key (admin)

POST/api/v1/rtb/sandbox/dsp/bidSandbox DSP for integration tests

Identityhttps://api.ltvadx.com

POST/api/v1/identity/resolveDevice id → IP → new household

POST/api/v1/identity/acr-signalStore an ACR viewing event

POST/api/v1/identity/consentStore a household's consent flags (not read by serving yet)

GET/api/v1/identity/household/{id}/segmentsSegments of a household (admin)

Campaign Managementhttps://api.ltvadx.com

GET/api/v1/campaignsList campaigns

POST/api/v1/campaignsCreate a campaign

PUT/api/v1/campaigns/{id}Update a campaign

PATCH/api/v1/campaigns/{id}/statusChange campaign status

POST/api/v1/ordersCreate an order (line items serve under an approved order)

GET/api/v1/line-itemsList line items

POST/api/v1/line-itemsCreate a line item with targeting

PUT/api/v1/line-items/{id}Update a line item

GET/api/v1/creativesList video creatives

POST/api/v1/creativesAdd a creative (VAST wrapper or video URL)

PATCH/api/v1/creatives/{id}/statusApprove or reject a creative (admin)

Publisher Inventoryhttps://api.ltvadx.com

GET/api/v1/channelsList channels

POST/api/v1/channelsCreate a channel

PUT/api/v1/channels/{id}Update a channel

PATCH/api/v1/channels/{id}/statusApprove or suspend a channel (admin)

GET/api/v1/direct-campaignsPublisher direct-sold campaigns

GET/api/v1/ad-breaksList ad-break records (informational)

Dealshttps://api.ltvadx.com

GET/api/v1/dealsList deals

POST/api/v1/dealsCreate a deal

PATCH/api/v1/deals/{id}/statusChange deal status

GET/api/v1/ssp/inventoryBrowse inventory (platform, country)

Reporting & Billinghttps://api.ltvadx.com

GET/api/v1/reports/deliveryDaily delivery rows (rates 0–1, money in USD micros)

GET/api/v1/reports/vcrVCR aggregate (rates as percentages)

GET/api/v1/reports/summaryTotals for a date range

GET/api/v1/reports/reach-frequencyReach & frequency (campaignId required)

GET/api/v1/rtb/reports/performanceRTB performance

GET/api/v1/exchange/summaryExchange summary (admin)

GET/api/v1/walletWallet balance and recent transactions

GET/api/v1/payoutsPublisher payouts

Attribution & Brand Lifthttps://api.ltvadx.com

POST/api/v1/attribution/eventsStore a conversion event

GET/api/v1/attribution/summaryConversions, equal-credit split by line item

GET/api/v1/brand-liftList brand lift studies (advertiserId)

POST/api/v1/brand-liftCreate a study record

Account & Adminhttps://api.ltvadx.com

POST/api/v1/account/api-keysCreate an API key (returned once)

GET/api/v1/account/api-keysList your API keys

POST/api/v1/context/switch/{assignmentId}Switch active context (new token)

GET/api/v1/activity-logsActivity log (admin)

GET/api/v1/auth/usersList users (admin)

PATCH/api/v1/auth/users/{id}/statusSuspend or reactivate a user (admin)

GET/api/v1/admin/settingsNetwork settings (admin)

Authentication

Control-plane endpoints (/api/v1/…) need a Bearer token. Ad serving, tracking and SSAI endpoints are public; /rtb/bid uses a seat key in X-Rtb-Api-Key.

Authorization: Bearer ltv_live_xxxxxxxxxxxx

# Create at Dashboard → Settings → API Keys (shown once).
# A key acts as its owner's login — same role and data scope.

RBAC & API key guide Partner APIs guide