SeatBid.seat
The ID of the buyer seat, such as an advertiser or agency account, on whose behalf these bids are made. Seat IDs are agreed between the bidder and the exchange in advance.
Field facts
- Path
seatbid.seat- Object
- SeatBid
- Type
- string
- Requirement
- Optional
- Added
- OpenRTB 2.0
- Spec section
- 4.2.2
How it is used
Exchanges check the seat against the request's BidRequest.wseat or BidRequest.bseat list, and against Deal.wseat for deal bids. It also fills the ${AUCTION_SEAT_ID} macro in notice URLs and markup.
Example
Where the field sits in a payload, with everything else left out:
{
"seatbid": [
{
"seat": "agency-412"
}
]
}Common mistakes
- Bidding with a seat outside the request's allow list or inside its block list (
openrtb.seatbid.seat_not_allowed). - Sending the bidder's own company name instead of the seat ID the exchange assigned.
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 | string | No | No |
| 2.3 to 2.6-202606 | string | No | No |
Related fields
Other SeatBid fields
For a walkthrough of the whole object, read Bid response anatomy.