BidResponse.id

The ID of the bid request this response answers, copied from BidRequest.id. Required.

CurrentstringRequiredSince 2.0

Field facts

Path
id
Object
BidResponse
Type
string
Requirement
Required
Added
OpenRTB 2.0
Spec section
4.2.1

How it is used

Copy the value verbatim, including case and any prefix. Exchanges may send a different request ID to each bidder, so echo what you received rather than an ID you derived. Your own tracking ID belongs in BidResponse.bidid.

Example

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

{
  "id": "80ce30c53c16e6ede735f123ef6e3236"
}

Common mistakes

  • Returning the bidder's own response ID here, so the exchange cannot match the response (openrtb.response.request_id_mismatch).
  • Converting a numeric-looking ID to a number, which changes its type and can drop leading zeros.

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.

VersionsType in the specRequiredDeprecated
2.0 to 2.2stringYesNo
2.3 to 2.6-202606stringYesNo

Related fields

Other BidResponse fields

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