BidResponse.seatbid

The array of SeatBid objects, one per buyer seat, that carries the actual bids. Required in 2.0 through 2.2; optional since 2.3, but a response that bids needs at least one entry.

Currentobject arrayOptionalSince 2.0

Field facts

Path: seatbid
Object: BidResponse
Type: object array
Requirement: Optional
Added: OpenRTB 2.0
Spec section: 4.2.1

How it is used

Leave it out, or send an empty array, only when you are not bidding, and then prefer HTTP 204 or a reason in BidResponse.nbr. The spec's no-bid guidance lists an empty seatbid array among the forms exchanges accept.

Example

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

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

Common mistakes

A response with neither seatbid nor nbr. The validator reports it as an error because it neither bids nor explains (openrtb.response.seatbid_or_nbr.required).
Returning one SeatBid object instead of an array of them.

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.

Versions	Type in the spec	Required	Deprecated
2.0 to 2.2	array of objects	Yes	No
2.3 to 2.6-202606	object array	No	No

Related fields

Other BidResponse fields

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