Introduction

The Curation API lets a curation partner create and manage programmatic
deals against Sovrn's supply: private-marketplace deals (pmp), where each
buyer names the seats that may transact, and open deals, which any buyer on
the DSP can transact on. 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 deal. POST /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 or DSP so they
   can transact on it.
3. Poll and edit. GET /deal-requests/{id} for live status;
   PATCH /deal-requests/{id} to edit the deal, its status included (see
   Editing a deal for the rules).

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 for each API key. A request over the
limit returns 429 (see Errors), so space out bulk operations
accordingly.

Guides

• Authentication: the x-api-key header and what a key
  can do.
• Deal lifecycle: deal types, statuses, and editing a
  deal.
• Targeting: the targeting model and the accepted values.
• Demand partners: the buyer slugs, the DV360 rules,
  and which deals let you set their status.
• Errors: error shapes and what to do about each.
• Testing: dry runs before you create a deal.
• Curation MCP: the same API for an AI client, at
  https://api.sovrn.com/sovrnos/v1/mcp, with the same key.

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