BidResponse§4.2.1 · Bid Response
This object is the top-level bid response object (i.e., the unnamed outer JSON object). The id attribute is a reflection of the bid request ID for logging purposes. Similarly, bidid is an optional response tracking ID for bidders. If specified, it can be included in the subsequent win notice call if the bidder wins. At least one seatbid object is required, which contains at least one bid for an impression. Other attributes are optional. To express a "no-bid", the options are to return an empty response with HTTP 204. Alternately if the bidder wishes to convey to the exchange a reason for not bidding, just a BidResponse object is returned with a reason code in the nbr attribute.
| Attribute | Type | Description |
|---|---|---|
| id required | string | ID of the bid request to which this is a response. |
| seatbid | object[] | Array of seatbid objects; 1+ required if a bid is to be made. |
| bidid | string | Bidder generated response ID to assist with logging/tracking. |
| cur default “USD” | string | Bid currency using ISO-4217 alpha codes. |
| customdata | string | Optional feature to allow a bidder to set data in the exchange’s cookie. The string must be in base85 cookie safe characters and be in any format. Proper JSON encoding must be used to include “escaped” quotation marks. |
| nbr | integer | Reason for not bidding. Refer to List 5.24. |
| ext | object | Placeholder for bidder-specific extensions to OpenRTB. |
Field descriptions reconciled against the official 2.6 draft; 2.5-specific fields come from a third-party Go implementation source (Apache 2.0), proofread against the official PDF · first-draft proofreading