Bid.api

A single API framework required by the markup, from the API Frameworks list. Added in 2.4 and deprecated in 2.6 in favor of Bid.apis.

Deprecated since 2.6-202204integerOptionalSince 2.4

Field facts

Path
seatbid.bid.api
Object
Bid
Type
integer
Requirement
Optional
Added
OpenRTB 2.4
Deprecated
OpenRTB 2.6-202204
Values
AdCOM list API Frameworks
Spec section
4.2.3

How it is used

Older bidders still send it. A 2.6 sender should fill apis, and may keep api with a consistent value while partners migrate.

Allowed values

ValueMeaning
1VPAID 1.0: VPAID 1.0, the first interactive video ad interface; superseded by VPAID 2.0 and rare in current players.
2VPAID 2.0: VPAID 2.0, still listed by some web players but not runnable on most CTV and app players.
3MRAID 1.0: MRAID 1.0 for in-app rich media; labeled MRAID until OpenRTB 2.2 renamed it MRAID-1.
4ORMMA: ORMMA, an early open in-app rich media interface that MRAID replaced.
5MRAID 2.0: MRAID 2.0, added in OpenRTB 2.2, with resizing, video playback, and other container features.
6MRAID 3.0: MRAID 3.0, added in OpenRTB 2.5, with exposure and audio events for in-app measurement.
7OMID 1.0: OMID 1.0: the player or SDK integrates the Open Measurement SDK for verification.
8SIMID 1.0: SIMID 1.0, the interactive layer for video ads that replaced VPAID interactivity. An AdCOM addition.
9SIMID 1.1: SIMID 1.1, a later version of the interactive video interface. An AdCOM addition.
500+Vendor-specific codes: Vendor-specific frameworks, meaningful only between partners that agreed on them in advance.

Example

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

{
  "seatbid": [
    {
      "bid": [
        {
          "api": 5
        }
      ]
    }
  ]
}

Common mistakes

  • Sending only api on a 2.6 response. The validator reports it as deprecated.

Version history

Added in OpenRTB 2.4, deprecated in 2.6-202204, and present in the latest snapshot. The table shows how each version's spec text types the field.

VersionsType in the specRequiredDeprecated
2.4 to 2.5integerNoNo
2.6-202210 to 2.6-202501integerNoYes
2.6-202505 to 2.6-202606integerNoYes

Related fields

Other Bid fields

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