Bid.id

The bidder's ID for this bid, used for logging and tracking. Required. Keep it unique within the response so each bid can be traced, especially when several bids target the same impression.

CurrentstringRequiredSince 2.0

Field facts

Path: seatbid.bid.id
Object: Bid
Type: string
Requirement: Required
Added: OpenRTB 2.0
Spec section: 4.2.3

Example

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

{
  "seatbid": [
    {
      "bid": [
        {
          "id": "bid-0001"
        }
      ]
    }
  ]
}

Common mistakes

Reusing the impression ID as the bid ID, so two bids on the same impression share an ID.

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	Yes	No
2.3 to 2.6-202606	string	Yes	No

Related fields

Bid.impid
BidResponse.bidid

Other Bid fields

adid
adm
adomain
api
apis
attr
bundle
burl
cat
cattax
cid
crid
dealid
dur
exp
ext
h
hratio
impid
iurl
langb
language
lurl
mtype
nurl
price
protocol
qagmediarating
slotinpod
tactic
w
wratio

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