Docs
Rule reference
Every issue carries a stable id and, where it applies, the JSON path that tripped it. The id is the contract: it does not change when wording changes, so you can match on it in CI.
Issue codes are not the whole rule set
The 386 ids below are the diagnostic codes: the kinds of finding RTBlint can report. They are not the body of rules. Each code is parameterized by the object, field, and version that tripped it, and the knowledge behind them comes from three sources:
- 64 versioned rules across OpenRTB 2.0 through 3.0, each with its own code (for example
openrtb.2.2.regs.coppaoropenrtb.2.3.imp.native) describing a field that was added, deprecated, moved, removed, or corrected in a specific release. - Per-version object catalogs defining every object and field. The 2.6-202606 catalog alone covers 38 objects and 417 fields; across 17 extracted catalogs in 18 documented versions that is 485 objects and 10,614 field definitions. Every presence, type, enum, and undefined-field check is driven by these.
- A semantic rule pack of cross-field checks the catalogs alone cannot express: SupplyChain node hygiene, GPP and US Privacy string coherence, CTV ad-pod duration sanity, native request encoding, and tmax/currency/bidfloor plausibility.
So a single code like openrtb.type.mismatch stands behind hundreds of concrete field checks. The table is the taxonomy; the catalog and rule pack are the coverage.
Diagnostic codes
Each code has its own page covering what it means, why it costs money, how to fix it, and a payload fragment that trips it. Click through any row.
| Rule id | Severity | Meaning |
|---|---|---|
| openrtb.privacy.signal_conflict | warning | A canonical privacy field and its legacy extension disagree. |
| openrtb.payload.invalid_json | error | The payload is not parseable JSON. No field rules run until this is fixed. |
| openrtb.payload.root_not_object | error | The JSON parses but the root is not an object. A bid request must be a single JSON object. |
| openrtb.field.required | error | A field the specification marks as required is missing at this path. |
| openrtb.field.undefined | error | The field is not defined in the canonical OpenRTB catalog for the selected version. Usually a typo or an invented key. |
| openrtb.field.deprecated | warning | The field still parses but is deprecated in the selected version. Migrate to its replacement. |
| openrtb.field.moved | error | The field moved to a different path in this version, for example regs.ext.gdpr to regs.gdpr. |
| openrtb.field.removed | error | The field was removed in the selected version and is no longer valid. |
| openrtb.field.not_yet_available | error | The field belongs to a later version than the one selected, so it is not valid against this snapshot. |
| openrtb.field.requires_skippable_video | error | The field only applies to skippable video and was used where skippability is not in effect. |
| openrtb.fields.mutually_exclusive | error | Two fields that cannot coexist were both present. Keep one. |
| openrtb.imp.media_type.required | error | An impression has no media-type object. Each imp needs a banner, video, audio, or native object. |
| openrtb.type.mismatch | error | The value has the wrong JSON type, for example a string where an integer is expected. |
| openrtb.value.invalid | error | The value is outside the documented set or range for this field, such as an out-of-range enum. |
| openrtb.version.unsupported | error | The targeted version has no usable catalog. Validation refuses rather than passing the payload silently. |
| openrtb.request.tmax_non_positive | error | tmax is zero or negative, leaving no time for bids to be received. |
| openrtb.request.tmax_implausible | warning | tmax is unusually high for an RTB auction; likely seconds instead of milliseconds. |
| openrtb.request.cur_format_invalid | warning | A cur entry is not a three-letter uppercase ISO-4217 currency code. |
| openrtb.imp.bidfloor_negative | error | bidfloor is negative; a CPM price cannot be negative. Also fires on Deal.bidfloor. |
| openrtb.imp.bidfloorcur_format_invalid | warning | bidfloorcur is not a three-letter uppercase ISO-4217 currency code. Also fires on Deal.bidfloorcur. |
| openrtb.regs.gpp_sid_without_gpp | warning | gpp_sid is present but gpp is absent or empty. |
| openrtb.regs.gpp_without_gpp_sid | warning | gpp is present but gpp_sid is absent or empty. |
| openrtb.regs.gpp_malformed | warning | regs.gpp does not decode as a GPP v1 header (type 3, version 1, Fibonacci section range), or uses an illegal character, or has no '~' sections. |
| openrtb.regs.gpp_section_mismatch | warning | The section ids encoded in the GPP header disagree with regs.gpp_sid, or the number of '~' payloads does not match the header. |
| openrtb.regs.tcf_malformed | warning | user.consent, legacy user.ext.consent, or a GPP section that should be TCF (sids 2 and 5), is not a TCF 2 core string (starts with C, long enough, TCF alphabet). |
| openrtb.regs.us_privacy_malformed | warning | us_privacy does not match the IAB US Privacy string shape: "1" followed by three Y/N/- characters. |
| openrtb.schain.duplicate_node | warning | Two adjacent SupplyChain nodes share the same asi and sid, as if a node were appended twice. |
| openrtb.schain.node.hp_missing | warning | A SupplyChain node has no hp field; the spec expects it to be propagated on every node. |
| openrtb.schain.node.identifier_empty | error | A SupplyChain node's asi or sid is an empty string. |
| openrtb.schain.ver_unexpected | warning | SupplyChain ver is something other than 1.0, the only published version. |
| openrtb.schain.incomplete | warning | complete is 0, declaring that at least one upstream node is missing from the path. |
| openrtb.schain.length_implausible | warning | The declared path has more than ten nodes, which is far longer than a real supply path. |
| openrtb.schain.duplicate_location | warning | A supply chain is declared at both source.schain and source.ext.schain. |
| openrtb.schain.node.hp_unexpected | warning | A SupplyChain node sets hp to something other than 1. |
| openrtb.schain.node.asi_not_domain | warning | A node's asi is not a bare domain: it carries a scheme, a path, a port, or whitespace. |
| openrtb.schain.node.asi_not_lowercase | warning | A node's asi contains uppercase characters; canonical domains are lowercase. |
| openrtb.resolve.sellers_json_unavailable | warning | The local cache has no sellers.json for this node's asi, so the hop cannot be authorised. |
| openrtb.resolve.sellers_json_unparseable | warning | The cached sellers.json for this hop exists but cannot be read as a sellers.json document. |
| openrtb.resolve.sid_not_in_sellers | error | This node's sid does not match any seller_id in the cached sellers.json for its asi. |
| openrtb.resolve.ads_txt_unavailable | warning | The local cache has no ads.txt for site.domain, so the first payment hop cannot be checked against the publisher's authorization file. |
| openrtb.resolve.ads_txt_unauthorized | error | The publisher's ads.txt does not list the first payment node's asi and sid as DIRECT or RESELLER. |
| openrtb.resolve.app_ads_txt_unavailable | warning | The local cache has no app-ads.txt for app.bundle, so the first payment hop cannot be checked against the app's authorization file. |
| openrtb.resolve.app_ads_txt_unauthorized | error | The app's app-ads.txt does not list the first payment node's asi and sid as DIRECT or RESELLER. |
| openrtb.video.pod.rqddurs_empty | warning | video.rqddurs is present as an empty array. |
| openrtb.video.pod.mincpmpersec_without_pod_context | warning | video.mincpmpersec is present without poddur or maxseq, which normally accompany a dynamic ad pod. |
| openrtb.native.request.double_encoded | error | native.request parses to another JSON string rather than an object: it was JSON-encoded twice. |
| openrtb.native.request.unparseable | warning | native.request does not parse as JSON at all. |
| openrtb.native.request.legacy_wrapper | warning | native.request is wrapped in a top-level "native" key, the pre-Native-1.1 convention. |
| openrtb.native.assets_missing | error | The Native Markup Request or Response has no assets array, or it is empty, and the response has no assetsurl either. |
| openrtb.native.asset.id_required | error | A native asset has no integer id, so the response cannot be mapped back to the request. |
| openrtb.native.asset.id_duplicate | error | Two native request assets share the same id, so a response cannot map assets unambiguously. |
| openrtb.native.asset.subtype_required | error | A native asset has none of those subtypes, or more than one. |
| openrtb.native.field_required | error | A Native Ads field the spec marks required is absent: title.len, data.type, video mimes/protocols/duration, eventtracker event/methods, or response text/url/vasttag/value/link.url. |
| openrtb.native.layout_removed | warning | The encoded native request still carries layout, which Native 1.1 replaced with plcmttype and context. |
| openrtb.native.value.invalid | error | data.type, img.type, eventtrackers.event, or methods carries a value Native Ads does not list (and it is below the vendor range 500+). |
| openrtb.native.asset.required_missing | error | The native request marked an asset required, and the bid's adm does not return that id. |
| openrtb.native.asset.id_unknown | error | The native adm returns an asset id the request never asked for. |
| openrtb.native.asset.type_mismatch | error | The response filled a request title slot with an image, or the other way around. |
| openrtb.response.seatbid_or_nbr.required | error | A bid response has neither a seatbid nor a no-bid reason code (nbr). |
| openrtb.bid.mtype_missing | warning | A bid carries adm markup but no mtype, on a version that defines mtype. The buyer is leaving the markup type to be sniffed. |
| openrtb.macro.unknown | warning | nurl, burl, lurl, or adm contains ${NAME} where NAME is not a documented AUCTION_* macro. |
| openrtb.bid.price_macro_missing | warning | nurl or burl is present but neither contains ${AUCTION_PRICE}, so the notice cannot report the clearing price. |
| openrtb.bid.loss_macro_missing | warning | lurl is present without ${AUCTION_LOSS}, so the notice cannot report why the bid lost. |
| openrtb.bid.adm.double_encoded | error | adm parses to another JSON string rather than an object: the native markup response was JSON-encoded twice. |
| openrtb.bid.adm.native_not_json | error | mtype 4 declares native markup, but adm is not a JSON Native Markup Response. |
| openrtb.bid.adm.markup_type_mismatch | error | The adm payload contradicts the declared mtype, for example a banner bid carrying a JSON payload. |
| openrtb.bid.adm.vast_root_missing | warning | A video or audio bid's adm is XML but has no VAST or DAAST document root. |
| openrtb.bid.adm.not_markup | warning | A video or audio bid's adm does not start with an XML tag, so it is unlikely to be a VAST document. |
| openrtb.pair.request_unusable | error | Cross-validation was asked for, but the paired bid request does not parse or is not an object. |
| openrtb.response.request_id_mismatch | error | The response id does not echo the id of the bid request it answers. |
| openrtb.response.cur_not_allowed | error | The response bids in a currency the request did not list in cur. |
| openrtb.seatbid.seat_not_allowed | error | The seat is absent from the request's wseat allowlist, or present in its bseat blocklist. |
| openrtb.bid.impid_unknown | error | A bid's impid does not match the id of any Imp in the bid request. |
| openrtb.bid.mtype_not_offered | error | The bid's mtype names a media type the referenced Imp does not offer, for example a banner bid on a video-only imp. |
| openrtb.bid.adm.media_type_mismatch | error | The markup sniffed from adm does not match any media subtype the referenced Imp offers. |
| openrtb.bid.dealid_unknown | warning | The bid's dealid is not among the referenced Imp's pmp deals. Out-of-band deals exist, so this is a warning. |
| openrtb.envelope.missing | error | An OpenRTB 3.0 payload has no openrtb wrapper. Sending a 2.x payload to a 3.0 validator lands here, with a note on where each object moved. |
| openrtb.envelope.ver_mismatch | warning | The envelope's ver declares a different OpenRTB version than the one being validated against. |
| openrtb.envelope.domainspec_unsupported | warning | The envelope names a domain spec other than AdCOM, so the objects under item.spec and bid.media are left unchecked. |
| adcom.placement.subtype_required | error | item.spec.placement has none of the media subtype objects AdCOM requires. |
| adcom.ad.subtype_required | error | bid.media.ad has none of the media subtype objects AdCOM requires. |
| adcom.asset.subtype_required | error | A native Asset object has none of the subtype objects AdCOM requires. |
| adcom.assetformat.subtype_required | error | A native AssetFormat object has none of the format subtype objects AdCOM requires. |
| openrtb.pair.unsupported_version | warning | Request/response cross-validation was asked for on OpenRTB 3.0; the checks are 2.x-only, so the response was validated on its own. |
| openrtb.dialect.bool_for_integer | error | A flag field arrived as a boolean. The specification types it as an integer, but the IAB OpenRTB protobuf schema declares it bool, so this is a protobuf JSON payload sent to a spec JSON reader. |
| openrtb.site.domain_not_domain | warning | site.domain contains a scheme, path, port, query, fragment, credentials or whitespace. |
| openrtb.dialect.oneof_conflict | error | A protobuf native oneof has multiple populated alternatives or both spellings of its object field. |
| openrtb.dialect.integer_for_bool | error | The payload was validated as protobuf JSON, and a field the OpenRTB protobuf schema declares bool arrived as an integer. A protojson parser rejects the whole payload. |
| openrtb.dialect.camel_case_name | warning | A field arrived under the lowerCamelCase name protojson emits by default, such as privateAuction for private_auction. The field was resolved and validated, but a JSON reader will not find it. |
| openrtb.eid.field_required | error | An Extended Identifier object has no source, no uids array, or a UID with no id. |
| openrtb.sua.browsers_empty | warning | device.sua is present but browsers is missing or empty, so it cannot replace device.ua. |
| openrtb.skadn.field_required | error | imp.ext.skadn or bid.ext.skadn is present but lacks a field the IAB SKAdNetwork OpenRTB extension requires. |
| openrtb.profile.field_required | error | An exchange profile was declared, and a field that exchange documents as required is missing or empty. |
| openrtb.profile.prebid.bidder_required | error | The Prebid Server profile was declared, and this Imp has no bidder targeting and no stored request that would supply it after merge. |
| openrtb.profile.field_forbidden | error | The payload contains a field the declared exchange documents as invalid on that endpoint. |
| openrtb.profile.value_invalid | error | A field the exchange documents has a closed value set, and this payload is outside it. |
| artf.payload.invalid_json | error | The RTBRequest or RTBResponse could not be parsed as JSON, so no envelope or mutation check can run. |
| artf.payload.root_not_object | error | The payload parses but its root is not an object. An RTBRequest and an RTBResponse are each a single message. |
| artf.field.required | error | The envelope is missing one of id, lifecycle, tmax, or bid_request, which the ARTF specification marks required. |
| artf.field.undefined | error | The envelope carries a member the ARTF proto does not define. Protobuf JSON rejects unknown fields by default. |
| artf.field.type_mismatch | error | bid_request or bid_response is present but is not a JSON object, so there is nothing to validate inside it. |
| artf.tmax.not_integer | error | tmax carries a non-integer value. It is the milliseconds the exchange allows for mutations to come back. |
| artf.tmax.non_positive | error | tmax is zero or negative, so the call is already out of budget when it arrives. |
| artf.tmax.implausible | warning | tmax exceeds 1000ms. The extension point runs inside an auction the exchange is already timing out, so a budget this large usually means seconds were sent as milliseconds. |
| artf.lifecycle.unknown | error | The lifecycle value is not one the ARTF enum defines, so the agent cannot tell which auction stage it is being called at. |
| artf.lifecycle.unspecified | error | The stage is explicitly unset, so the agent does not know which payload is authoritative or which intents apply. |
| artf.lifecycle.payload_mismatch | error | lifecycle is LIFECYCLE_DSP_BID_RESPONSE but the envelope has no bid_response, so response-stage intents have nothing to target. |
| artf.lifecycle.payload_unexpected | warning | lifecycle is LIFECYCLE_PUBLISHER_BID_REQUEST, which runs before any DSP has answered, yet the envelope carries a bid_response. |
| artf.originator.type_unknown | error | The business entity type is outside the enum, so the agent cannot tell whose payload it is being asked to change. |
| artf.originator.id_missing | warning | The originator names a type but no identity, so the agent cannot tell which business entity owns the payload. |
| artf.intents.missing | warning | The agent is not told which intents it may return, and the orchestrator has no declared basis for rejecting the ones it gets. |
| artf.intents.not_array | error | applicable_intents is a repeated field, so its JSON form is an array even when it holds one value. |
| artf.intents.empty | warning | The list is present but empty, so every mutation the agent returns is out of scope by definition. |
| artf.intent.unknown | error | One of the declared intents is not an ARTF Intent value, so the agent cannot tell what is actually being offered. |
| artf.request_unusable | error | The envelope passed alongside the mutation set is not a JSON object, so no mutation can be checked against the auction it targets. |
| artf.response.id_missing | error | The response carries no id, so the orchestrator cannot tie the mutations back to the extension point call it made. |
| artf.response.id_mismatch | error | The response id is not the extension point request id. The envelope id is not the bid request id, and confusing the two is the common failure. |
| artf.response.metadata_missing | warning | Without api_version and model_version, an orchestrator cannot record which agent build produced these mutations. |
| artf.mutations.empty | warning | The agent returned an empty mutation set, so the orchestrator paid for the call and has nothing to evaluate. |
| artf.mutation.not_object | error | An entry in the mutations array is not a Mutation object, so it carries no intent, operation, or path to check. |
| artf.mutation.intent_unknown | error | The declared intent is outside the enum, so the orchestrator cannot tell why the change is being proposed. |
| artf.mutation.intent_unspecified | error | The mutation declares no purpose, so it cannot be evaluated independently, which is what ARTF requires of every change. |
| artf.mutation.intent_not_applicable | error | The mutation declares an intent the orchestrator did not offer on this call, so it is rejected on arrival. |
| artf.mutation.op_unknown | error | The operation is outside the enum, so the orchestrator cannot tell whether to add, replace, or remove at the target path. |
| artf.mutation.op_unspecified | error | The operation is unset, so the change has a target and a value but no verb. |
| artf.mutation.op_not_applicable | warning | The mutation removes at a path while declaring an intent that adjusts a price or a floor, where replace is the operation that applies. |
| artf.mutation.path_missing | error | path is required: it is the semantic reference naming which auction entity the mutation applies to. |
| artf.mutation.path_not_absolute | error | ARTF semantic paths are rooted at the payload, so they begin with /. |
| artf.mutation.path_unrecognized | warning | The path is rooted and well formed but is not one of the semantic references ARTF v1.0 documents, so only a prior agreement can resolve it. |
| artf.mutation.path_intent_mismatch | warning | The intent and the path disagree: segment activation pointed at a bid, or bid shading pointed at an impression. |
| artf.mutation.imp_unknown | error | The imp id in the path is not among the impressions in the bid request the envelope carried. |
| artf.mutation.deal_unknown | error | The deal id in the path is not among the deals the impression's pmp object carries, so there is no floor or margin to adjust. |
| artf.mutation.bid_unknown | error | The seat and bid id in the path do not resolve to a bid in the carried bid response. |
| artf.mutation.target_payload_missing | error | The path addresses a bid and the RTBRequest has no bid_response to mutate. |
| artf.mutation.payload_missing | error | The mutation names an intent and a target but carries none of the value oneof members, so there is nothing to apply. |
| artf.mutation.payload_ambiguous | error | value is a protobuf oneof, so exactly one payload member may be present. |
| artf.mutation.payload_intent_mismatch | error | The mutation sets a payload member the intent does not carry, such as adjust_bid on a deal activation. |
| artf.mutation.ids_empty | error | The mutation proposes no ids, so it changes nothing while still consuming an evaluation slot. |
| artf.mutation.bidfloor_negative | error | The floor adjustment carries a negative price, which OpenRTB has no meaning for. |
| artf.mutation.margin_negative | error | The margin adjustment carries a negative value, whether it is expressed as CPM or as a percentage. |
| artf.mutation.margin_implausible | warning | A PERCENT margin above 100 would take the whole bid and more. |
| artf.mutation.price_missing | error | BID_SHADE proposes a new bid price, and adjust_bid.price is absent. |
| artf.mutation.price_negative | error | The shaded price is below zero, which no auction can settle. |
| artf.mutation.metrics_empty | error | ADD_METRICS proposes no metrics, so the mutation adds nothing to the impression. |
| artf.mutation.metric_type_missing | error | OpenRTB requires Metric.type. Without it, whoever receives the mutated request cannot interpret the value. |
| artf.mutation.no_openrtb_target | warning | Margin is not part of the OpenRTB Deal object, so the orchestrator has to apply it out of band and no validator can check the result. |
| artf.mutation.legacy_spec_encoding | warning | The mutation is written the way the ARTF v1.0 document's examples are, with camelCase intents and a value wrapper, rather than the enum names and oneof members its own .proto defines. |
| openrtb.profile.adform.dsa_name_length | error | Adform DSA advertiser names must contain at most 100 Unicode characters. |
| openrtb.profile.adform.dsa_parameter | error | Adform DSA targeting parameter must be 1, 2, or 3. |
| openrtb.profile.adform.dsa_required | error | Adform requires DSA response information when the Handler request's DSA requirement is 2 or 3. |
| openrtb.profile.adform.native_image_size | error | Adform Native image requests need image dimensions; unbounded images do not generate impressions. |
| openrtb.profile.adform.schain_nodes | error | Adform's declared supply chain requires at least one node. |
| openrtb.profile.applovin.advertiser_domain | error | AppLovin requires an advertiser domain. |
| openrtb.profile.applovin.api_unsupported | error | AppLovin ALX does not support VPAID or ORMMA. |
| openrtb.profile.applovin.clicktrackers | error | AppLovin HTML with SKAdNetwork requires click trackers. |
| openrtb.profile.applovin.creative_type | error | AppLovin creative type must identify a supported HTML, MRAID, Native or VAST format. |
| openrtb.profile.applovin.currency | error | AppLovin ALX accepts only USD; omitting currency defaults to USD. |
| openrtb.profile.applovin.macro_context | error | AppLovin substitutes AUCTION_LOSS only in lurl. |
| openrtb.profile.applovin.native_video | error | AppLovin ALX Native does not support video assets. |
| openrtb.profile.applovin.publisher_bundle | error | AppLovin rejects publisher app.bundle used as the advertised app bundle. |
| openrtb.profile.applovin.response_size | error | ALX documents a 4 KB maximum bid response; this JSON body exceeds 4096 UTF-8 bytes. |
| openrtb.profile.applovin.seat_format | error | A supplied AppLovin seat must be an alphanumeric string of at most 40 characters. |
| openrtb.profile.applovin.skadn_campaign | error | AppLovin SKAdNetwork campaign must be an integer string in its version-specific range. |
| openrtb.profile.applovin.skadn_fidelity | error | AppLovin SKAdNetwork fidelities must not be empty. |
| openrtb.profile.applovin.skadn_mismatch | error | AppLovin SKAdNetwork itunesitem must match advertised bid.bundle. |
| openrtb.profile.applovin.skadn_nonce | error | AppLovin SKAdNetwork nonce must use UUID format. |
| openrtb.profile.applovin.skadn_timestamp | error | AppLovin SKAdNetwork timestamp must be a decimal Unix timestamp in milliseconds, expressed as a string. |
| openrtb.profile.applovin.skadn_version | error | AppLovin SKAdNetwork version must be 2.0 or above. |
| openrtb.profile.bidswitch.audio_url | error | Audio format 3 needs either VAST or DAAST URL. |
| openrtb.profile.bidswitch.bid_count | error | Buyer responses allow at most two bids per ad slot across all seats. |
| openrtb.profile.bidswitch.billing_macro | error | The buyer billing URL must contain the win price macro. |
| openrtb.profile.bidswitch.click_macro | error | Creative markup may contain the supplier click tracking macro at most once. |
| openrtb.profile.bidswitch.creative_id_recommended | warning | BidSwitch recommends adid or crid for creative review. |
| openrtb.profile.bidswitch.domain_ascii | error | Advertiser domains must use ASCII, including punycode for international domains. |
| openrtb.profile.bidswitch.dsa_name_length | error | DSA names have a maximum of 100 characters. |
| openrtb.profile.bidswitch.impression_macro | error | The win price macro may appear once in adm and cannot appear in both adm and nurl. |
| openrtb.profile.bidswitch.inventory_conflict | error | A DOOH request cannot also contain site or app. |
| openrtb.profile.bidswitch.inventory_required | error | BidSwitch requires a documented inventory context. |
| openrtb.profile.bidswitch.markup_macro | error | Markup document URLs cannot contain the win price macro. |
| openrtb.profile.bidswitch.markup_version | error | Buyer adm requires a declared protocol version of at least 4.0. |
| openrtb.profile.bidswitch.native_version | error | Supplier native markup requires version 1.2. |
| openrtb.profile.bidswitch.s2s_markup_macro | error | Server-to-server notification requests forbid the win price macro in adm. |
| openrtb.profile.bidswitch.seat_unique | error | All bids from a buyer seat must be grouped into one SeatBid. |
| openrtb.profile.bidswitch.secure_notification | error | Browser win notifications on secure inventory require HTTPS. |
| openrtb.profile.bidswitch.user_id_length | error | BidSwitch user identifiers have a maximum of 50 characters. |
| openrtb.profile.bidswitch.value_invalid | error | The extension value is outside the BidSwitch documented set. |
| openrtb.profile.bidswitch.video_url | error | Video bids need ext.vast_url or the documented nurl fallback. |
| openrtb.profile.commerce_grid.banner_format | error | Commerce Grid requires banner formats, even for a single size. |
| openrtb.profile.commerce_grid.currency_offer | error | Commerce Grid requires at least one allowed bid currency. |
| openrtb.profile.commerce_grid.language_conflict | error | Commerce Grid accepts only one of wlang and wlangb. |
| openrtb.profile.commerce_grid.metric_value | error | Commerce Grid metric values must be between 0 and 1. |
| openrtb.profile.commerce_grid.native_privacy | error | Commerce Grid native requests require privacy 1. |
| openrtb.profile.commerce_grid.skadn_mismatch | error | Commerce Grid SKAdNetwork sourceapp must match publisher app.bundle. |
| openrtb.profile.digital_turbine.array_empty | error | DT supply chain needs at least one node. |
| openrtb.profile.digital_turbine.clicktrackers | error | DT display Auto Store and SKOverlay click firing needs a nonempty tracker list. |
| openrtb.profile.digital_turbine.creative_type | error | DT ext.crtype must identify the creative type when supplied. |
| openrtb.profile.digital_turbine.currency | error | DT supports only USD. |
| openrtb.profile.digital_turbine.deal_mismatch | error | DT response dealid must reference a deal in the matched impression. |
| openrtb.profile.digital_turbine.framework | error | DT reports its app framework as unity or native. |
| openrtb.profile.digital_turbine.macro_context | error | DT supports AUCTION_MIN_TO_WIN only in nurl. |
| openrtb.profile.digital_turbine.native_asset | error | DT Native producer asset IDs 1 through 7 identify title, main image, video, icon, description, rating and CTA respectively. |
| openrtb.profile.digital_turbine.native_version | error | DT Native requests use version 1.2. |
| openrtb.profile.digital_turbine.percentage | error | DT user percentages range from 0 through 100. |
| openrtb.profile.digital_turbine.playable_attr | error | DT Rewarded Playable responses require creative attribute 13. |
| openrtb.profile.digital_turbine.price_macro | error | DT requires AUCTION_PRICE in nurl, burl or an adm tracking pixel. |
| openrtb.profile.digital_turbine.producer_value | error | DT producer field contains a value outside its documented emitted subset. |
| openrtb.profile.digital_turbine.skadn_campaign | error | DT SKAdNetwork 2 and 3 campaign ranges 1 through 100. |
| openrtb.profile.digital_turbine.skadn_mismatch | error | DT request SKAdNetwork sourceapp must match app.bundle. |
| openrtb.profile.digital_turbine.skadn_nonce | error | DT attribution nonce must be a UUID string. |
| openrtb.profile.digital_turbine.skadn_sourceidentifier | error | DT SKAdNetwork 4 sourceidentifier is a four-digit string from 0001 through 9999. |
| openrtb.profile.digital_turbine.skadn_timestamp | error | DT attribution timestamp must be a decimal Unix millisecond string. |
| openrtb.profile.digital_turbine.skadn_version | error | DT supports SKAdNetwork 2.0 and later. |
| openrtb.profile.digital_turbine.source_conflict | warning | DT sources give conflicting, conditional or optional presence guidance; verify this field against your integration. |
| openrtb.profile.digital_turbine.store_categories | error | DT caps store subcategories at three strings. |
| openrtb.profile.digital_turbine.store_id | error | DT Auto Store requires a store listing ID in bundle or SKAdNetwork itunesitem. |
| openrtb.profile.dv360.banner_markup | error | DV360 always includes adm for banner bids. |
| openrtb.profile.dv360.duplicate_deal | error | DV360 deal IDs must be unique within an impression. |
| openrtb.profile.dv360.gma_dependency | error | disable_gma_format is permitted only with gdemsignals. |
| openrtb.profile.dv360.ignored_field | warning | DV360 parses the field but does not use it for bidding. |
| openrtb.profile.dv360.instream_sound | error | DV360 sound-off playback must be classified as outstream. |
| openrtb.profile.dv360.inventory_required | error | DV360 requests require site or app inventory. |
| openrtb.profile.dv360.ios_bundle | error | DV360 iOS app bundles must be numeric App Store IDs. |
| openrtb.profile.dv360.ip_required | error | DV360 requires the device IPv4 or IPv6 address. |
| openrtb.profile.dv360.native_version | error | DV360 supports Native Ads 1.2; versions 1.0 and 1.1 are unsupported. |
| openrtb.profile.dv360.privacy_locations | warning | DV360 expects one US Privacy signal location. |
| openrtb.profile.dv360.protocols_required | error | DV360 video requires a nonempty supported protocol list. |
| openrtb.profile.dv360.schain_expected | warning | DV360 requires SupplyChain in almost all integrations; an exemption needs account context. |
| openrtb.profile.equativ.app_identity_advisory | warning | The Equativ App table marks bundle required, but its parent description strongly recommends App ID or Bundle ID. Missing bundle is advisory while these source requirements conflict. |
| openrtb.profile.equativ.bid_limit | error | Equativ supplier responses contain at most ten bid objects. |
| openrtb.profile.equativ.deal_type | error | Equativ dealtype must be one of its four documented strings. |
| openrtb.profile.equativ.directpay_once | error | Publisher directpay can be sent only once in a request. |
| openrtb.profile.equativ.dsa_name_length | error | Equativ DSA advertiser and payer names have a maximum of 100 Unicode characters. |
| openrtb.profile.equativ.impression_limit | error | Equativ accepts at most ten impression objects in a supplier request. |
| openrtb.profile.equativ.mainline_precedence | warning | Equativ prioritizes the mainline field when both mainline and legacy values are present. |
| openrtb.profile.equativ.mio_first_only | warning | Equativ processes only the first non-instream impression when placement tag IDs are missing or differ. Unified requests also require account activation. |
| openrtb.profile.equativ.network_id | error | Supplier requests must provide the Equativ network identifier through publisher.id or the configured ext.network_id method. |
| openrtb.profile.equativ.obsolete_rewarded | warning | The Equativ guide marks video.ext.rewarded obsolete and recommends imp.rwdd. Current 2.6 acceptance is not promised. |
| openrtb.profile.equativ.video_placement | error | Equativ requires video placement information. Modern plcmt or documented legacy placement supplies it. |
| openrtb.profile.equativ.zero_dimension | warning | Equativ ignores requests with an explicitly zero width or height. |
| openrtb.profile.field_type | error | DT DSP Dual End Card uses JSON true or false. |
| openrtb.profile.google.billing_id_not_offered | warning | The selected Google billing ID is not offered by the referenced impression. With a sole ID and no active child seats Google may ignore this field; account configuration is unavailable. |
| openrtb.profile.google.billing_id_required | error | A Google bid must select ext.billing_id when its impression offers multiple billing IDs. |
| openrtb.profile.google.collapsible_size_exceeded | error | The expanded Google collapsible-ad the field exceeds the impression's the field. |
| openrtb.profile.google.deal_billing_id_not_offered | error | The Google deal's non-empty billing_id list does not offer the selected billing ID. |
| openrtb.profile.google.deal_media_not_offered | error | The bid's mtype is excluded by the Google deal's creative_constraints.mtypes. |
| openrtb.profile.google.dsa_paid_required | error | Google's DSA declaration requires paid, including when the payer and advertiser are the same. |
| openrtb.profile.google.event_token_ignored | warning | Google ignores event notification token payloads longer than 128 UTF-8 bytes. |
| openrtb.profile.google.frequency_caps_unsupported | error | Google's request explicitly declares fcap_scope=NONE (1), so frequency-capped bids are filtered. |
| openrtb.profile.google.landing_page_required | error | Authorized Buyers bids must declare a click URL in ext.clickurl, an advertiser domain in adomain, or both. |
| openrtb.profile.google.oneof_conflict | error | Google's protobuf oneof permits at most one of these fields. |
| openrtb.profile.google.sdk_declared_creative_required | error | The SDK declared ad must specify one supported creative content field. |
| openrtb.profile.google.sdk_field_required | error | Google's selected buyer SDK ad contract requires this bid field, even when the general protocol marks it optional. |
| openrtb.profile.google.sdk_native_field_required | error | https://developers.google.com/static/authorized-buyers/rtb/downloads/openrtb-proto.txt. |
| openrtb.profile.google.sdk_native_image_type_required | error | https://developers.google.com/static/authorized-buyers/rtb/downloads/openrtb-adx-proto.txt. |
| openrtb.profile.google.sdk_not_offered | error | Google SDK-rendered ads require an installed_sdk submessage in the corresponding app request. |
| openrtb.profile.google.sdk_params_not_offered | error | openrtb.profile.google.sdk_native_image_type_required. |
| openrtb.profile.google.sdk_renderer_conflict | error | Google filters bids that select a buyer SDK creative and a separate ordinary or AMP creative. |
| openrtb.profile.google.value_invalid | error | the field the field. |
| openrtb.profile.index.adomain_expected | warning | Index expects adomain unless the impression is passed on; that exception needs integration context. |
| openrtb.profile.index.adomain_length | error | Index advertiser domains allow at most 128 characters. |
| openrtb.profile.index.banner_size_unoffered | error | The banner creative dimensions must match an offered fixed format. |
| openrtb.profile.index.currency | error | Index's published DSP requests use USD. |
| openrtb.profile.index.deal_discount | error | Index deal discounts are fractions from 0.01 through 1.0. |
| openrtb.profile.index.dsa_length | error | Index DSA names allow at most 100 characters. |
| openrtb.profile.index.ip_required | error | Index supplier requests require device.ip or device.ipv6. |
| openrtb.profile.index.metric_probability | error | Index probability metrics must be from 0.0 through 1.0. |
| openrtb.profile.index.native_wrapper | error | Index native bid markup requires an outer native object. |
| openrtb.profile.index.pod_id_mismatch | error | Index supplier requests with multiple video impressions require the same podid for a single ad pod. |
| openrtb.profile.index.seat_expected | warning | Index normally requires seat, but can disable it per DSP; account configuration is unavailable. |
| openrtb.profile.index.site_identity | error | Index supplier site requests require domain or page. |
| openrtb.profile.index.skad_bundle | error | SKAdNetwork itunesitem must match bid.bundle. |
| openrtb.profile.index.skad_network | error | The SKAdNetwork response network must match an offered request ID. |
| openrtb.profile.index.tmax_minimum | error | Index supplier requests allow at least 100 milliseconds. |
| openrtb.profile.index.video_protocol | error | Index requires at least one supported video protocol. |
| openrtb.profile.index.vpaid_api | error | Index requires VPAID API 1 or 2 with application/javascript video. |
| openrtb.profile.inmobi.banner_size_required | error | InMobi supplier banners require positive w/h or a format with positive w/h. |
| openrtb.profile.inmobi.bapp_limit | error | InMobi sends at most 30 blocked app bundles. |
| openrtb.profile.inmobi.category_required | error | InMobi requires the creative's IAB categories. |
| openrtb.profile.inmobi.creative_id_truncated | warning | InMobi truncates creative IDs longer than 64 characters. |
| openrtb.profile.inmobi.device_address | warning | The supplier guide labels both IP families required but does not define the alternative or privacy redaction behavior. Confirm address availability for this integration. |
| openrtb.profile.inmobi.history_count | error | InMobi histories contain at most five entries; purchase and advertiser histories are omitted when empty. |
| openrtb.profile.inmobi.history_order | warning | InMobi documents recent history first; its advertiser example conflicts with this ordering. |
| openrtb.profile.inmobi.inventory_required | error | InMobi supplier ingest requires app or site inventory context; the current FAQ supports both directions. |
| openrtb.profile.inmobi.percentage_range | error | InMobi percentage telemetry must be an integer from 0 to 100. |
| openrtb.profile.inmobi.placement_required | error | InMobi supplier ingest requires tagid or ext.placementid. |
| openrtb.profile.inmobi.play_store_state | error | InMobi omits Play Store version when psdisable is 1. |
| openrtb.profile.inmobi.quality_declaration | warning | InMobi Getting Started requires this quality declaration; the current response table labels it recommended. Confirm the active integration contract. |
| openrtb.profile.inmobi.schain_nodes | error | InMobi's declared supply chain requires at least one node. |
| openrtb.profile.inmobi.sdk_expected | warning | The outgoing guide says this field is passed by the InMobi SDK; verify SDK version and producer configuration. |
| openrtb.profile.inmobi.single_format | error | InMobi sends each format opportunity to DSPs in a separate request. |
| openrtb.profile.inmobi.skadnetwork_unoffered | error | The response SKAdNetwork must match a requested skadnetids entry. |
| openrtb.profile.inmobi.supplier_unsupported | warning | The supplier request guide labels this object unsupported in its current version; negotiated integration support is not visible here. |
| openrtb.profile.inmobi.video_experience | error | InMobi video experience IDs are 1, 2 and 3. |
| openrtb.profile.inmobi.video_experience_unoffered | error | InMobi portrait and vertical experiences must be explicitly offered in the request. |
| openrtb.profile.inmobi.video_linearity | error | InMobi outgoing video opportunities use linearity 1. |
| openrtb.profile.magnite.api_not_offered | error | The referenced impression does not offer the Magnite creative API framework. |
| openrtb.profile.magnite.array_limit | error | Magnite xAPI the field permits at most the field entries. |
| openrtb.profile.magnite.deprecated | warning | The public Magnite xAPI model marks this extension field deprecated; no account-side behavior is inferred. |
| openrtb.profile.magnite.insecure_tracker | error | Magnite xAPI requires HTTPS impression trackers when the referenced impression is secure. |
| openrtb.profile.magnite.media_not_offered | error | The Magnite xAPI creative format was not offered by the referenced impression. |
| openrtb.profile.magnite.mime_mismatch | error | The Magnite banner response MIME type differs from the requested markup format. |
| openrtb.profile.magnite.size_not_offered | error | The Magnite banner size ID was not included in the explicit primary or alternate size IDs. |
| openrtb.profile.magnite.type_invalid | error | The supplied Magnite xAPI extension does not match its public field type or integer width. |
| openrtb.profile.mobilefuse.badv_limit | error | MobileFuse supports at most 50 blocked advertiser domains. |
| openrtb.profile.mobilefuse.bid_for_ignored_imp | warning | MobileFuse documents processing only the first impression; this bid references a later impression. |
| openrtb.profile.mobilefuse.currency | error | MobileFuse auctions use USD. |
| openrtb.profile.mobilefuse.device_address_invalid | error | The address must use the documented IP family. |
| openrtb.profile.mobilefuse.device_address_required | error | MobileFuse requires ip or ipv6. |
| openrtb.profile.mobilefuse.impressions_ignored | warning | MobileFuse processes only the first impression; later impressions are ignored. |
| openrtb.profile.mobilefuse.native_version | warning | MobileFuse expects Native Ads 1.2. |
| openrtb.profile.mobilefuse.sdk_signal_required | error | MobileFuse SDK bidding requires the SDK token in the first data segment. |
| openrtb.profile.mobilefuse.sdk_signal_size | error | The SDK token may be at most 4000 UTF-8 bytes. |
| openrtb.profile.mobilefuse.tmax_minimum | error | MobileFuse tmax must be at least 100 milliseconds. |
| openrtb.profile.native_encoding | error | This exchange requires a Native request encoded as an object or a JSON object string. |
| openrtb.profile.openwrap.adpod_count | error | CTV ad counts must be positive after OpenWrap's zero defaults (minads 1, maxads 3). |
| openrtb.profile.openwrap.adpod_count_order | error | CTV minads cannot exceed maxads after applying defaults. |
| openrtb.profile.openwrap.adpod_duration | error | An explicit CTV adpod requires positive adminduration and admaxduration. |
| openrtb.profile.openwrap.adpod_duration_order | error | CTV adminduration cannot exceed admaxduration. |
| openrtb.profile.openwrap.adpod_exclusion | error | CTV exclusion percentages must be between 0 and 100. |
| openrtb.profile.openwrap.ctv_video_required | error | The selected OpenWrap CTV endpoint requires at least one video impression. |
| openrtb.profile.openwrap.schain_removed | warning | The CTV middleware removes this supply chain because its helper requires version 1.0, a complete flag, nonempty nodes, nonempty ASI/SID, SID at most 64 characters, and hp 1. |
| openrtb.profile.prebid.alias_noop | error | PBS aliases must not map a bidder code to itself. |
| openrtb.profile.prebid.alias_not_declared | error | A PBS alias GVL ID must reference a declared request alias. |
| openrtb.profile.prebid.cache_type_required | error | PBS cache configuration requires bids or vastxml. |
| openrtb.profile.prebid.currency_truncated | warning | PBS-Go uses only the first request currency and drops subsequent entries. |
| openrtb.profile.prebid.media_not_offered | error | The PBS bid marker ext.prebid.type=the field references an impression without that media object. Stored-request media cannot be resolved locally. |
| openrtb.profile.prebid.media_type_mismatch | error | The PBS ext.prebid.type marker contradicts the bid's mtype. |
| openrtb.profile.prebid.multibid_normalized | warning | PBS-Go clamps maxbids to the supported range 1 through 9. |
| openrtb.profile.scope.unsupported | warning | {} has no verified OpenRTB {} {} contract in this build. Canonical specification checks were applied. |
| openrtb.profile.sovrn.protocols | error | Sovrn video requires supported protocols. |
| openrtb.profile.triplelift.assetsurl_unsupported | error | Native assetsurl requires request aurlsupport=1; omission means unsupported. |
| openrtb.profile.triplelift.banner_format_empty | error | TripleLift's required format array must describe at least one banner size. |
| openrtb.profile.triplelift.banner_format_fallback | warning | TripleLift labels format required but recommends w/h when it is absent. This request uses that documented fallback. |
| openrtb.profile.triplelift.bundle_contract_conflict | warning | TripleLift's app table requires bundle while its prose says an app ID or bundle is not strictly required. Confirm the active supplier contract. |
| openrtb.profile.triplelift.event_enum | error | Native event and method IDs must be standard IDs or exchange-specific values of at least 500. |
| openrtb.profile.triplelift.event_unoffered | error | The returned Native event and tracking method must be among the request's declared options. |
| openrtb.profile.triplelift.image_size_recommended | warning | TripleLift recommends an exact or minimum native image dimension. |
| openrtb.profile.triplelift.jstracker_markup | error | TripleLift Native 1.2 jstracker contains HTML with script tags. |
| openrtb.profile.unity.advertiser_domain | error | Unity accepts exactly one advertiser domain. |
| openrtb.profile.unity.creative_type | error | Unity ext.crtype must be a documented creative type (case-insensitive). |
| openrtb.profile.unity.deal_not_offered | error | Unity response dealid must match a deal ID offered by the referenced impression. |
| openrtb.profile.unity.impression_count | error | Unity emits exactly one impression per request. |
| openrtb.profile.unity.impression_id | error | Unity's sole impression has the string id 1. |
| openrtb.profile.unity.price_invalid | error | Unity bid price must be greater than zero. |
| openrtb.profile.unity.price_precision | error | Unity accepts at most three decimal places in bid price. |
| openrtb.profile.unity.skadn_campaign | error | Unity SKAdNetwork 2.x and 3.x campaign is an integer string from 1 through 100. |
| openrtb.profile.unity.skadn_mismatch | error | Unity SKAdNetwork sourceapp must identify the publisher app.bundle. |
| openrtb.profile.unity.skadn_sourceidentifier | error | Unity SKAdNetwork sourceidentifier is a four-digit string. |
| openrtb.profile.unity.skadn_timestamp | error | Unity SKAdNetwork timestamp must be a Unix-milliseconds integer string. |
| openrtb.profile.unity.type_invalid | error | Unity SKAdNetwork fidelities entries must be objects. |
| openrtb.profile.unity.value_invalid | error | Unity video placement is 1 or 5. |
| openrtb.profile.vungle.currency_ignored | warning | Vungle treats the response currency as USD, including a supplied non-USD value. |
| openrtb.profile.vungle.idfv_context | error | Vungle IDFV extensions are emitted only for iOS devices. |
| openrtb.profile.vungle.idfv_mismatch | error | Vungle ext.ifv and ext.idfv must contain the same IDFV. |
| openrtb.profile.vungle.macro_context | error | Vungle minimum-bid-to-win macros are supported only in lurl. |
| openrtb.profile.vungle.native_icon_size | error | Vungle Native app icons must be at least 80 by 80 pixels when supplied. |
| openrtb.profile.vungle.native_image_extension | error | Vungle Native image URL must have a supported image file extension before its query or fragment. |
| openrtb.profile.vungle.native_main_image | error | Vungle Native requires main-image asset id 1. |
| openrtb.profile.vungle.native_unsupported | warning | Vungle does not support Native the field. |
| openrtb.profile.vungle.native_version | error | Vungle supports Native Ads version 1.2. |
| openrtb.profile.vungle.skadn_campaign | error | Vungle SKAdNetwork campaign must be an integer string in the version-specific range (1 through 100 before 4.0, 0 through 9999 in 4.0 and later). |
| openrtb.profile.vungle.skadn_mismatch | error | Vungle SKAdNetwork itunesitem must match the advertised bid.bundle when supplied. |
| openrtb.profile.vungle.skadn_nonce | error | Vungle SKAdNetwork fidelity nonce must use UUID syntax. |
| openrtb.profile.vungle.skadn_sourceidentifier | error | Vungle sourceidentifier is a four-digit integer string for SKAdNetwork 4.0 and later. |
| openrtb.profile.vungle.skadn_timestamp | error | Vungle SKAdNetwork timestamp is a Unix-milliseconds integer string. |
| openrtb.profile.vungle.skadn_version | error | Vungle request SKAdNetwork versions must be 2.0 or later; Vungle does not advertise 2.1. |
| openrtb.profile.vungle.skoverlay_disabled | error | Vungle disallows other SKOverlay attributes when show is 0. |
| openrtb.profile.vungle.type_invalid | error | Vungle user.ext.consent is an integer 0 or 1, or a configured TCF consent string. |
| openrtb.profile.vungle.value_invalid | error | Vungle source.ext.omidpn is vungle when supplied. |
| openrtb.profile.vungle.vast_prefix | error | Vungle VAST markup must start its VAST element within the first 100 bytes. |
| openrtb.profile.xandr.array_limit | error | Xandr sends at most 64 blocked advertiser domains. |
| openrtb.profile.xandr.billing_url_required | error | Xandr non-impression payment bids require a billing notify URL in bid.burl. |
| openrtb.profile.xandr.notify_macro | error | Xandr does not document $the field}} in bid.the field. |
| openrtb.profile.xandr.payment_currency | error | Xandr viewable-impression payment bids support USD only. |
| openrtb.profile.xandr.payment_not_offered | error | The Xandr request does not offer this payment type for the referenced impression. |
| openrtb.profile.xandr.pod_duration | error | This Xandr creative is longer than the entire offered dynamic pod. |
| openrtb.profile.xandr.slot_not_offered | error | Xandr bid.slotinpod may identify a guaranteed position only when the seller offered one. |
| openrtb.profile.xandr.string_limit | error | Xandr custom macro values have a maximum length of 550 characters. |
| openrtb.profile.xandr.type_invalid | error | Xandr the field has an invalid documented JSON type. |
| openrtb.profile.yandex.ad_type | error | Yandex SDK ad type must be banner, interstitial, rewarded, appopenad, or native. |
| openrtb.profile.yandex.bidder_token | error | Yandex SDK Open Bidding requires the SDK bidder token in user.data[].segment[].signal. |
| openrtb.profile.yandex.currency_offer | error | Yandex SDK Open Bidding needs a supported request currency. |
| openrtb.profile.yandex.ignored_impressions | warning | Yandex SDK Open Bidding considers only the first impression. |
| openrtb.profile.yandex.impression_mismatch | error | Yandex SDK Open Bidding responses must reference the first offered impression. |
| openrtb.profile.yandex.macro_context | error | Yandex substitutes AUCTION_LOSS only in lurl and AUCTION_MIN_TO_WIN only in nurl or lurl. |
| openrtb.profile.yandex.response_count | error | A Yandex SDK Open Bidding response contains one SeatBid and one bid. |
Severities
An error means the payload is invalid against the selected version. A warning means it still parses but uses something deprecated you should migrate away from. The tester counts each separately so you can gate on errors and triage warnings.
See what RTBlint checks for the categories behind these ids, or OpenRTB versions for how the selected snapshot changes which ids fire.