SeatBid.bid

The array of Bid objects made for this seat, each tied to one impression in the request. At least one is required, and several bids may target the same impression.

Currentobject arrayRequiredSince 2.0

Field facts

Path
seatbid.bid
Object
SeatBid
Type
object array
Requirement
Required
Added
OpenRTB 2.0
Spec section
4.2.2

How it is used

Returning more than one bid per impression helps when the exchange filters some of them against publisher block lists. The spec's deal guidance also recommends returning deal bids alongside open auction bids rather than only the single best one. Exchanges differ in how many bids per impression they accept, so check the integration docs.

Example

Where the field sits in a payload, with everything else left out:

{
  "seatbid": [
    {
      "bid": [
        {
          "id": "b1",
          "impid": "1",
          "price": 2.15,
          "mtype": 1
        }
      ]
    }
  ]
}

Common mistakes

  • A SeatBid with an empty bid array. Drop the seat instead, or return no bid at all.
  • Sending a single Bid object instead of an array.

Version history

Added in OpenRTB 2.0, and present in the latest snapshot. The table shows how each version's spec text types the field.

VersionsType in the specRequiredDeprecated
2.0 to 2.2array of objectsYesNo
2.3 to 2.6-202606object arrayYesNo

Related fields

Other SeatBid fields

For a walkthrough of the whole object, read Bid response anatomy.