--- layout: api_prebidjs title: pbjs.getBidResponses() description: getBidResponses API sidebarType: 1 --- This function returns the bid responses at the given moment. **Kind**: static method of `pbjs`. **Returns**: `object` - map | object that contains for each ad unit the array of bid responses. For backwards compatibility, the arrays expose the array also under the `.bids` property. **Returned Object Params**: {: .table .table-bordered .table-striped } | Param | Type | Description | | |---------------------+---------+---------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------------| | `bidder` | String | The bidder code. Used by ad server's line items to identify bidders | `rubicon` | | `adId` | String | The unique identifier of a bid creative. It's used by the line item's creative as in [this example](/adops/gam-creative-banner-sbs.html). | `123` | | `width` | Integer | The width of the returned creative size. | 300 | | `height` | Integer | The height of the returned creative size. | 250 | | `size` | String | The width x height of the returned creative size. | "300x250" | | `cpm` | Float | The exact bid price from the bidder. The [`bidCpmAdjustment`](/dev-docs/publisher-api-reference/bidderSettings.html#22-bidcpmadjustment) is applied, but not the [price granularity](/dev-docs/publisher-api-reference/setConfig.html#price-granularity). | 1.59 | | `pbLg`,`pbMg`,`pbHg`,`pbAg`,`pbDg`,`pbCg` | String | CPM quantized to a granularity: Low (pbLg), Medium (pbMg), High (pbHg), Auto (pbAg), Dense (pbDg), and Custom (pbCg). | "5.00" | | `currency` | String | Currency of the bid CPM | `"USD"` | | `netRevenue` | Boolean | True if bid is Net, False if Gross | `true` | | `requestTimestamp` | Integer | The time stamp when the bid request is sent out in milliseconds | 1444844944106 | | `responseTimestamp` | Integer | The time stamp when the bid response is received in milliseconds | 1444844944185 | | `timeToRespond` | Integer | The amount of time for the bidder to respond with the bid | 79 | | `adUnitCode` | String | adUnitCode to get the bid responses for | "/9968336/header-bid-tag-0" | | `creativeId` | String | Bidder-specific creative ID | `"12345678"` | | `mediaType` | String | One of: banner, native, video | `banner` | | `dealId` | String | (Optional) If the bid is [associated with a Deal]({{site.baseurl}}/adops/deals.html), this field contains the deal ID. | "ABC_123" | | `adserverTargeting` | Object | Contains all the adserver targeting parameters | `{ "hb_bidder": "msft", "hb_adid": "7a53a9d3" }` | | `native` | Object | Contains native key value pairs. | `{ "title": "", "body": "" }` | | `status` | String | Status of the bid. Possible values: targetingSet, rendered | `"targetingSet"` | | `ttl` | Integer | How long (in seconds) this bid is considered valid. See this [FAQ entry]({{site.github.url}}/dev-docs/faq.html#does-prebidjs-cache-bids) for more info. | `300` | | `meta` | Object | (Optional) Contains additional meta information about the bid. | `{ "advertiserDomains": [ "wherewindsmeetgame.com" ] }` | | `meta.advertiserDomains` | String[] | (Optional) Array with the advertiser domains | | | `meta.advertiserId` | String | (Optional) The id of the advertiser | | | `meta.advertiserName` | String | (Optional) The name of the advertiser | | | `meta.agencyId` | String | (Optional) The id of the agency | | | `meta.agencyName` | String | (Optional) The name of the agency | | | `meta.brandId` | String | (Optional) The id of the brand | | | `meta.brandName` | String | (Optional) The name of the brand | | | `meta.dchain` | String | (Optional) | | | `meta.deal` | Object | (Optional) Deal metadata for bids with a `dealId`, since Prebid.js 11.43. See [Deal metadata](/dev-docs/bidder-adaptor.html#bidder-adaptor-deal-metadata). | | | `meta.demandSource` | String | (Optional) | | | `meta.mediaType` | String | (Optional) | | | `meta.networkId` | String | (Optional) The id of the network | | | `meta.networkName` | String | (Optional) The name of the network | | | `meta.primaryCatId` | String | (Optional) | | | `meta.secondaryCatIds` | String[] | (Optional) | |
```json { "/9968336/header-bid-tag-0": [ { "bidderCode": "msft", "width": 300, "height": 250, "adId": "7a53a9d3", "creative_id": 29681110, "cpm": 0.5, "adUrl": "https://nym1.ib.adnxs.com/ab?e=wqT_3QLzBKBqAgAAAgDWAAUIkav6sAUQucfc0v-nzQcYj…r=http%3A%2F%2Flocal%3A4000%2Fexamples%2Fpbjs_partial_refresh_example.html", "requestTimestamp": 1444844944095, "responseTimestamp": 1444844944180, "timeToRespond": 85, "adUnitCode": "/19968336/header-bid-tag-0", "bidder": "msft", "usesGenericKeys": true, "size": "300x250", "adserverTargeting": { "hb_bidder": "msft", "hb_adid": "7a53a9d3", "hb_pb": "0.50" } },{ "bidderCode": "pubmatic", "width": "300", "height": "250", "adId": "1139e34e14", "adSlot": "39620189@300x250", "cpm": 1, "ad": " ", "adUrl": "https://aktrack.pubmatic.com/AdServer/AdDisplayTrackerServlet?operId=1&pubId…local%3A4000%2Fexamples%2Fpbjs_partial_refresh_example.html&lpu=hotels.com", "dealId": "", "requestTimestamp": 1444844944105, "responseTimestamp": 1444844944354, "timeToRespond": 249, "adUnitCode": "/19968336/header-bid-tag-0", "bidder": "pubmatic", "usesGenericKeys": true, "size": "300x250", "adserverTargeting": { "hb_bidder": "pubmatic", "hb_adid": "1139e34e14", "hb_pb": "1.00" } }, { "bidderCode": "rubicon", "width": "300", "height": "250", "adId": "130d3b0d9b", "cpm": 0.795995, "ad": "", "ad_id": "3161645", "sizeId": "15", "requestTimestamp": 1444844944116, "responseTimestamp": 1444844944396, "timeToRespond": 280, "adUnitCode": "/19968336/header-bid-tag-0", "bidder": "rubicon", "usesGenericKeys": true, "size": "300x250", "adserverTargeting": { "hb_bidder": "rubicon", "hb_adid": "130d3b0d9b", "hb_pb": "0.50" } } ], "/9968336/header-bid-tag1": [ { "bidderCode": "casale", "width": 0, "height": 0, "adId": "108c0ba49d", "requestTimestamp": 1444844944130, "responseTimestamp": 1444844944223, "timeToRespond": 93, "cpm": 0, "adUnitCode": "/19968336/header-bid-tag1", "bidder": "casale" }, { "bidderCode": "openx", "width": "728", "height": "90", "adId": "14d7f9208f", "ad_id": "537161420", "cpm": 1.717, "ad": "