BidRequest.bseat

A block list of buyer seat IDs that may not bid on this request. Added in 2.5; the IDs must be agreed with bidders in advance.

Currentstring arrayOptionalSince 2.5

Field facts

Path: bseat
Object: BidRequest
Type: string array
Requirement: Optional
Added: OpenRTB 2.5
Spec section: 3.2.1

How it is used

Use it when a publisher wants to exclude a few buyers rather than name every permitted one. Only one of BidRequest.wseat and bseat should appear, and omitting both means no seat restriction.

Example

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

{
  "id": "req-1",
  "bseat": [
    "seat-3307"
  ]
}

Common mistakes

Sending bseat together with wseat.
Bidding from a blocked seat. The validator reports the pairing as openrtb.seatbid.seat_not_allowed.

Version history

Added in OpenRTB 2.5, 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.5	string array	No	No
2.6-202210 to 2.6-202606	string array	No	No

Related fields

Other BidRequest fields

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