> For the complete documentation index, see [llms.txt](https://targetmycom.gitbook.io/openrtb_spec/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://targetmycom.gitbook.io/openrtb_spec/openrtb/vk-ad-network-rtb-protocols/bidresponse-specification-requirements.md).

# BidResponse specification requirements

| name    | type                 | description                                                                                                                              |
| ------- | -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| id      | string; **required** | Specifies the ID of the bid request to which this is a response to, for example, "d7d1e107-fe7c-4a57-9592-d1d41fa702d9"                  |
| seatbid | array of objects     | An array of Seat Bid objects, see the Seat Bid Object section. The length of the array can be either 1+ (for yes-bid) or 0 (for no-bid). |
| cur     | string; **required** | Sets the bidding currency using ISO-4217 alphabetic codes. If not provided USD is assumed, "USD"                                         |
| ext     | object               | The bid response extension object. This field may be omitted in No Bid Responses, see the Bid Response Ext Object section.               |
| bidid   | string; **required** | Bidder generated response ID to assist with logging/tracking                                                                             |

#### Object Seatbid.Bid

| name     | type                       | description                                                                                                                                                                                                                 |
| -------- | -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| id       | string; **required**       | Bidder generated bid ID to assist with logging/tracking.                                                                                                                                                                    |
| impid    | string; **required**       | ID of the Imp object in the related bid request.                                                                                                                                                                            |
| price    | float; **required**        | Bid price expressed as CPM although the actual transaction is for a unit impression only. Note that while the type indicates float, integer math is highly recommended when handling currencies (e.g., BigDecimal in Java). |
| adomain  | string array; **required** | Advertiser domain for block list checking (e.g., “ford.com”). This can be an array of for the case of rotating creatives. Exchanges can mandate that only one domain is allowed.                                            |
| adid     | string; recommended        | ID of a preloaded ad to be served if the bid wins                                                                                                                                                                           |
| adm      | string; **required**       | <p></p><p>Creative markup for ads (banner, native, video).</p><p></p>                                                                                                                                                       |
| iurl     | string; recommended        | URL without cache-busting to an image that is representative                                                                                                                                                                |
| cid      | string; recommended        | Campaign ID to assist with ad quality checking; the collection of creatives for which iurl should be representative                                                                                                         |
| crid     | string; recommended        | Creative ID to assist with ad quality checking.                                                                                                                                                                             |
| nurl     | string; recommended        | Win notice URL called by the exchange if the bid wins (not necessarily indicative of a delivered, viewed, or billable ad); optional means of serving ad markup.                                                             |
| burl     | string; recommended        | Billing notice URL called by the exchange when a winning bid becomes billable based on exchange-specific business policy (e.g., typically delivered, viewed, etc.).                                                         |
| lurl     | string; recommended        | Loss notice URL called by the exchange when a bid is known to have been lost.                                                                                                                                               |
| ext.type | string; recommended        | Type ads in adm: banner, video, native                                                                                                                                                                                      |

**Bid Response extension**

| **name**                 | **type** | **description**                                                                    |
| ------------------------ | -------- | ---------------------------------------------------------------------------------- |
| .ext.bannerd.debug\_info | string   | Debug info                                                                         |
| .ext.agerestrictions     | string   | Age restriction like "18+" (is added to the beginning of .title.text as "\[18+] ") |

**Loss notification** VK Ad Network supports notifications to automatically block creatives when the following statuses are received in ${AUCTION\_LOSS}

| code | **description**                                                                            |
| ---- | ------------------------------------------------------------------------------------------ |
| 200  | Creative Filtered - General; reason unknown.                                               |
| 201  | 201 Creative Filtered - Pending processing by Exchange (e.g., approval, transcoding, etc.) |
| 202  | Creative Filtered - Disapproved by Exchange                                                |
| 1001 | Creative blocked at Publisher site or app                                                  |
| 1002 | Publisher site or app using test\_mode                                                     |