Bid.dur

The duration of the video or audio creative in seconds. Added in 2.6.

CurrentintegerOptionalSince 2.6-202204

Field facts

Path: seatbid.bid.dur
Object: Bid
Type: integer
Requirement: Optional
Added: OpenRTB 2.6-202204
Spec section: 4.2.3

How it is used

Pod-based requests need it to fit ads into a break. The exchange compares it with Video.rqddurs, the range in Video.minduration and Video.maxduration, and the pod's total time. It should match the duration in the VAST markup.

Example

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

{
  "seatbid": [
    {
      "bid": [
        {
          "dur": 30
        }
      ]
    }
  ]
}

Common mistakes

A dur that disagrees with the duration in the VAST document, so the creative overruns the slot the exchange planned.

Version history

Added in OpenRTB 2.6-202204, 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.6-202204	Added in the first 2.6 release, published without a structured text archive; the 2.6-202210 republication is the first tagged text.
2.6-202210 to 2.6-202606	integer	No	No

Related fields

Other Bid fields

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