Introduction

Create and manage programmatic deals against Sovrn's curated supply.

The Curation API lets a curation partner create and manage programmatic
deals (PMP) against Sovrn's supply. You submit a deal request; Sovrn creates the
deal in real time and returns a Sovrn external deal ID (SVN_…) that you hand to
your buyer or DSP. You can then poll the deal's status and edit it.

How it works

  1. Create a dealPOST /deal-requests with your targeting, buyers,
    pricing, and schedule. Sovrn creates the deal synchronously and returns its
    SVN_… id.
  2. Hand off the deal ID — give the SVN_… id to your buyer/DSP so they can
    transact on it.
  3. Poll and editGET /deal-requests/{id} for live status;
    PATCH /deal-requests/{id} to change pricing, targeting, buyers, or
    schedule.

Base URL

https://api.sovrn.com/sovrnos/v1

Production is the only environment available to partners.

Rate limit

Requests are limited to 15 per minute. If you exceed it, requests are
throttled — space out bulk operations accordingly.

The full endpoint documentation lives in the API Reference section of this
Developer Center.


Did this page help you?