Deal Requests

Get a deal request

The status-polling endpoint: status is refreshed from source (30-second cache), and statusAsOf reports when it was last confirmed. statusSettable reports whether this deal is one whose status you can set yourself, so you never have to infer it from the buyers. On a review deal that a buyer did not accept, buyerIssues names that buyer and says what it reported, with the field to correct where there is one.

get/deal-requests/{id}

Request

  • Base URL
    https://api.sovrn.com/sovrnos/v1
  • URL
    https://api.sovrn.com/sovrnos/v1/deal-requests/{id}
  • Auth
    API key in header x-api-key

Path parameters

idstring required

Response

The deal request.

dealRequestIdstring required
status'active' | 'archived' | 'paused' | 'scheduled' | 'review' | 'dsp review' required
statusAsOfstring date-time required
statusSettableboolean required
namestring required
descriptionstring nullable required
type'pmp' | 'open' required
adFormat'audio' | 'banner' | 'native' | 'video' required
environmentsEnvironment[] required
runOfNetworkboolean required
createdAtstring date-time required
updatedAtstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.