DSP bid response payload reference

Integration Partners
Last Updated: July 31, 2026•

Note: This reference applies whether your container is hosted in Index Cloud or on your own infrastructure (partner-hosted). The fields and privacy rules described here are the same for both deployment models.

This reference describes the fields included in the outbound request at the DSPClosed Demand-Side Platform (DSP). A software platform that automates bidding decisions in real-time and efficiently connects buyers and audiences through an ad exchange or SSP. Also known as a buy-side platform. Bid ResponseClosed An OpenRTB response that is sent by the DSP in response to the SSP's or ad exchange's bid request. It is an event directed back to the seller expressing a valuation for the request and conditions of sale. extension point, and how privacy settings affect each field. For the shading logic that consumes these fields, see Implementing bid shading.

RTBRequest

The outbound request contains the following top-level fields:

FieldNotes

RTBRequest.tmax

Time budget for the request, in milliseconds

RTBRequest.originator.type

Identifies the originator type as DSP - TYPE_DSP

RTBRequest.originator.id

Index's interpretation used to identify the DSP

RTBRequest.lifecycle

Identifies the request as a DSP bid response request - LIFECYCLE_DSP_BID_RESPONSE

RTBRequest.id

UUID generated for the request

RTBRequest.bid_response

Contains the bid response payload that was returned to the DSP for the RTBRequest.bid_request

RTBRequest.bid_request

Contains the bid requestClosed An OpenRTB request that is sent from a supply-side platform (SSP) or ad exchange to the DSP requesting a bid response for potential impressions. A bid request contains information about the impression that allows the DSP to decide whether to bid on the impression. payload that was sent to the DSP

RTBRequest.applicable_intents

List of intents applicable to this request - BID_SHADE

How privacy settings affect this data

Specific fields containing personally identifiable information (PII) are anonymized, masked, or omitted based on the request user's consent status.

  • DPA opt-out: Providers that opt out of the data provider agreement are opted out of receiving PII entirely.

  • Consent anonymization: This applies when the provider is not registered in the CMP, or if the user has not provided consent to share data with that provider.

RTBRequest.bid_request

The bid_request object contains the following fields:

FieldNotes

bid_request.id

As provided

bid_request.site.page

As provided. Page URL is sanitized - query string, fragment, and embedded credentials are removed

bid_request.app.bundle

As provided

bid_request.device.ua

As provided, if device present

bid_request.device.ip

May be partially masked or withheld depending on privacy settings

bid_request.device.ipv6

May be partially masked depending on privacy settings

bid_request.device.didsha1

May be withheld depending on privacy settings

bid_request.device.didmd5

May be withheld depending on privacy settings

bid_request.device.dpidsha1

May be withheld depending on privacy settings

bid_request.device.dpidmd5

May be withheld depending on privacy settings

bid_request.device.ifa

May be withheld depending on privacy settings

bid_request.device.carrier

As provided, if device present

bid_request.device.language

As provided, if device present

bid_request.device.make

As provided, if device present

bid_request.device.model

As provided, if device present

bid_request.device.os

As provided, if device present

bid_request.device.osv

As provided, if device present

bid_request.device.hwv

As provided, if device present

bid_request.device.w

As provided, if device present

bid_request.device.h

As provided, if device present

bid_request.device.ppi

As provided, if device present

bid_request.device.pxratio

As provided, if device present

bid_request.device.connectiontype

As provided, if device present

bid_request.device.devicetype

As provided, if device present

bid_request.device.lmt

As provided, if device present

bid_request.device.sua.browsers[*].brand

As provided, if sua present

bid_request.device.sua.browsers[*].version

As provided, if sua present

bid_request.device.sua.platform.brand

As provided, if sua present

bid_request.device.sua.platform.version

As provided, if sua present

bid_request.device.sua.mobile

As provided, if sua present

bid_request.device.sua.architecture

As provided, if sua present

bid_request.device.sua.bitness

As provided, if sua present

bid_request.device.sua.model

As provided, if sua present

bid_request.device.sua.source

As provided, if sua present

bid_request.device.geo.lat

May be rounded or withheld depending on privacy settings

bid_request.device.geo.lon

May be rounded or withheld depending on privacy settings

bid_request.device.geo.country

May be withheld depending on privacy settings

bid_request.device.geo.region

May be withheld depending on privacy settings

bid_request.device.geo.regionfips104

May be withheld depending on privacy settings

bid_request.device.geo.metro

May be withheld depending on privacy settings

bid_request.device.geo.city

May be withheld depending on privacy settings

bid_request.device.geo.zip

May be partially masked or withheld depending on privacy settings

bid_request.device.geo.type

As provided, if geo present

bid_request.device.geo.ipservice

As provided, if geo present

bid_request.device.geo.utcoffset

As provided, if geo present

bid_request.user

May be withheld entirely depending on privacy settings

bid_request.user.id

As provided, if user present

bid_request.user.consent

As provided, if user present

bid_request.regs

May be withheld depending on privacy settings

bid_request.regs.coppa

As provided, if regs present

bid_request.regs.gdpr

As provided, if regs present

bid_request.regs.us_privacy

As provided, if regs present

bid_request.regs.gpp

As provided, if regs present

bid_request.regs.gpp_sid

As provided, if regs present

bid_request.source.tid

As provided, if source present

bid_request.source.pchain

As provided, if source present

bid_request.imp[*].bidfloor

As provided

bid_request.imp[*].ext.gpid

As provided

bid_request.imp[*].pmp.private_auction

As provided

bid_request.imp[*].pmp.deals[*].id

As provided

bid_request.imp[*].pmp.deals[*].bidfloor

As provided

bid_request.imp[*].pmp.deals[*].bidfloorcur

As provided

bid_request.imp[*].pmp.deals[*].at

As provided

bid_request.imp[*].pmp.deals[*].wseat

As provided

RTBRequest.bid_response

The bid_response object contains the following fields:

FieldNotes

bid_response.cur

As provided

bid_response.seatbid[*].seat

As provided

bid_response.seatbid[*].bid[*].id

As provided

bid_response.seatbid[*].bid[*].adomain

As provided

bid_response.seatbid[*].bid[*].bundle

As provided

bid_response.seatbid[*].bid[*].cid

As provided

bid_response.seatbid[*].bid[*].dealid

As provided

bid_response.seatbid[*].bid[*].h

As provided

bid_response.seatbid[*].bid[*].mtype

As provided

bid_response.seatbid[*].bid[*].price

As provided

bid_response.seatbid[*].bid[*].tactic

As provided

bid_response.seatbid[*].bid[*].w

As provided