BidResponse.nbr
A code explaining why the bidder is not bidding, such as 2 for an invalid request or 8 for an unmatched user. Values come from the No-Bid Reason Codes list kept in the OpenRTB 3.0 document, with 500 and above for exchange-specific codes. Added in 2.2.
Field facts
- Path
nbr- Object
- BidResponse
- Type
- integer
- Requirement
- Optional
- Added
- OpenRTB 2.2
- Values
- AdCOM list No-Bid Reason Codes
- Spec section
- 4.2.1
How it is used
Send it with BidResponse.id and no bids. The codes cover errors (0 to 2), traffic quality (3 to 5), targeting and caps (6 to 10), ads.txt and ads.cert checks (11 to 14), auction time (15), and supply chain checks (16 and 17). Exchanges that log these codes can tell an integration fault from a pricing decision, which makes them most valuable during onboarding.
Example
Where the field sits in a payload, with everything else left out:
{
"nbr": 2
}Common mistakes
- Sending
nbralongside real bids. The code describes a response that does not bid. - Returning 2 for every pass. Reserve it for requests the bidder could not parse or accept.
Version history
Added in OpenRTB 2.2, 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.2 | integer | No | No |
| 2.3 to 2.5 | integer | No | No |
| 2.6-202210 to 2.6-202606 | integer | No | No |
Related fields
Other BidResponse fields
For a walkthrough of the whole object, read Bid response anatomy.