Bid Request v3.0

This is the top level object that is sent to the Buyer. Each bid request sent from BidSwitch to a Buyer will contain all of the fields marked with (Required). Many optional and (Recommended) fields will also be included depending in the situation.

Bid Request Object Properties

Value	Type	Description
id	string	(Required) Unique ID of the bid request, provided by BidSwitch, for example, "b5ba5ed2-547e-4e86-8a84-34a440dad6db"
tmax	integer	Maximum time in milliseconds the exchange allows for bids to be received to avoid timeout, including internet latency, for example, 120.
at	integer	Auction type, the default value is 2. 1: the first price auction 2: the second price auction Note: There is an additional auction type field, item.ext.at, used to pass other values and signals, see the Item Object section for more details
cur	array of strings	Array of allowed currencies for bids on this bid request using ISO-4217 alpha codes, for example, ["USD", "EUR"]
seat*	array of strings	An array of Buyer seats allowed to bid on this auction, for example [58, 61, 99]. If this field is present, the specified seat IDs may be supplied using BidSwitch or Supplier taxonomy. A bid request may contain multiple seat IDs using the Supplier taxonomy. The bid response should contain the appropriate seat value corresponding to one of the values of the seat field, for more details see the Seat Bid Object section.
wseat*	int	Indicates whether the seat field is a black or white list of Buyer IDs. 0 means black List 1 means a white list, and is the default Hint: Also please take note of how a wseat field is used differently in the item.deal object.
source*	object	Indicates the entity responsible for the final impression sale decision, see the Source Object.
item	Array of Objects	(Required) An array of objects containing the details of the items for auction, see the Item Object section. For BidSwitch, there is a maximum of 5 items within this array per request.
package*	int	Flag to indicate if the Exchange can verify that the items offered represent all of the items available in context (e.g., all impressions on a web page, all video spots such as pre/mid/post roll) to support road-blocking, where 0 = no, 1 = yes.
context*	object	(Required) Contains the context of the inventory up for auction, i.e. the site, app, or dooh object along with the user, device, regs, restrictions and others, see Context Object

All Request Fields

• Source Object
  • Source Extension
  • SupplyChain Object
  • Supply Chain Nodes
  • Example Source JSON
• Request Extension
• Ads.txt Object
• Item Object
  • Item JSON Example
• Deal Object
  • Deal JSON Example
• Item Metric
  • Metric JSON Example
• Item Spec
• Item Placement
  • Placement JSON Example
• Display Placement
  • Display Format
  • Display JSON Example
• Display Event
  • Event Extension Object
  • Event JSON example
• Native Display
  • Native Asset Object
  • Native Asset Title Object
  • Native Asset Image Object
  • Native Asset Video Object
  • Native Asset Data Object
• Video Placement
  • Example Video Object
• Audio Placement
  • Audio Object Example
• Companion Ad
• Context Object
  • Example Context JSON
• Regulations Context
• Restrictions Context
  • Restrictions Extension
  • Additional Categories
  • Restrictions JSON Example
• Site Context
  • Site JSON Example
• App Context
  • App JSON Example
• DOOH Context
  • DOOH JSON Example
• Publisher Object
  • Publisher JSON Example
• User Context
  • User Ext Object
  • Cross-Platform UID
  • Consented Provider Settings
  • User JSON Example
• Device Context
• Geo Context
  • Geo Object Example
• User Data Context
  • Segment Object
• Bid Request JSON Examples
  • Display Example
  • Rewarded Video Example
  • In-App Request
  • Audio Request
  • TV Request
  • Native Request