Bid.dealid

The ID of the private marketplace deal this bid is made under, copied from Deal.id in the impression's Imp.pmp. Added in 2.2.

CurrentstringOptionalSince 2.2

Field facts

Path: seatbid.bid.dealid
Object: Bid
Type: string
Requirement: Optional
Added: OpenRTB 2.2
Spec section: 4.2.3

How it is used

Without it the exchange treats the bid as an open auction bid, which loses the deal's terms and is rejected outright when Pmp.private_auction is 1. A bidder with both deal and open auction demand for the impression can return a bid for each.

Example

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

{
  "seatbid": [
    {
      "bid": [
        {
          "dealid": "PMP-2026-0412"
        }
      ]
    }
  ]
}

Common mistakes

A deal ID that was not offered on that impression (openrtb.bid.dealid_unknown). Deals agreed outside the request exist, so confirm the exchange accepts them.
Attaching the deal ID to a bid on a different impression from the one that carried the deal.

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	string	No	No
2.3	string	No	No
2.3.1	string	No	No
2.4 to 2.5	string	No	No
2.6-202210 to 2.6-202606	string	No	No

Related fields

Other Bid fields

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