BidRequest.wseat
An allow list of buyer seat IDs, such as advertiser or agency accounts, permitted to bid on this request. Seat IDs must be agreed between bidder and exchange in advance.
Field facts
- Path
wseat- Object
- BidRequest
- Type
- string array
- Requirement
- Optional
- Added
- OpenRTB 2.0
- Spec section
- 3.2.1
How it is used
When wseat is present, only bids from listed seats are eligible, and bidders should filter their campaigns before bidding rather than after. Use either wseat or BidRequest.bseat, never both; if neither is present, any seat may bid. Restrictions that apply to a single deal belong in Deal.wseat.
Example
Where the field sits in a payload, with everything else left out:
{
"id": "req-1",
"wseat": [
"agency-412",
"agency-977"
]
}Common mistakes
- Sending both
wseatandbseat(openrtb.fields.mutually_exclusive). - Listing seat IDs from another bidder's namespace, which excludes every real bidder without any error.
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 | array of ing b o F * t e b a | No | No |
| 2.1 | array of ing b o F [ t e b a | No | No |
| 2.2 | array of ings b o F [ t e b a | No | No |
| 2.3 to 2.6-202606 | string array | No | No |
Related fields
Other BidRequest fields
For a walkthrough of the whole object, read Bid request anatomy.