For general information, see SFX APIs: Using JSON.
Authentication
A Demand-Side Platform (DSP) may have one or multiple endpoints represented by buyer platform entities in its system. For each endpoint, an authentication token for using Deal Discovery API can be created.
For each buyer platform, there is only one active and unique token. It is, therefore, both an authentication and an identification parameter.
Deals Response Parameters
| Property | Description | Type |
|---|---|---|
| id | The deal ID | string |
| description | A text description of the deal | string |
| start | The start date time of the deal as ISO 8601 format | string |
| end | The end date time as ISO 8601 format (absent if no end) | string |
| auction_type | The code for the auction type (3 for fixed price, 2 otherwise) | integer |
| floor_price | The applied floor price (if the auction type is 3, this will be the fixed price. Can be absent if no demand-side floor price) | float |
| floor_price_currency | The floor price currency in ISO 4217 format (absent if no floor price) | string |
| seats | The list of seats being able to be called for this deal | array of strings |