> For the complete documentation index, see [llms.txt](https://docs.blueseasx.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.blueseasx.com/server-bidding/server-integration/bidrequest-object.md).

# BidRequest Object

<table data-header-hidden data-search="false"><thead><tr><th></th><th></th><th width="316.70703125"></th><th></th></tr></thead><tbody><tr><td><strong>Attribute</strong></td><td><strong>Type</strong></td><td><strong>Description</strong></td><td><strong>Required</strong></td></tr><tr><td>id</td><td>string</td><td>Unique ID of the bid request</td><td>yes</td></tr><tr><td>imp</td><td>object array</td><td>Array of Impression objects representing the impressions offered (see Impression object). This array contains one impression object.</td><td>yes</td></tr><tr><td>app</td><td>object</td><td>Details about the publisher’s app, via an App object (see <a href="/pages/g9jVr1vpNLuWJqaSeR73">App object</a>).</td><td>yes</td></tr><tr><td>device</td><td>object</td><td>Details about the user’s device to which the impression is delivered, via a Device object (see <a href="/pages/4w5oRBgbkITVKG4QSPVx">Device object</a>).</td><td>yes</td></tr><tr><td>user</td><td>object</td><td>Details about the human user of the device: the advertising audience  (see <a href="/pages/mMZXyM46U81fUj4fzMk4">User object</a>).</td><td>yes</td></tr><tr><td>tmax</td><td>integer</td><td>Maximum time in milliseconds supply side allows for bids to be received including Internet latency to avoid timeout</td><td>no</td></tr><tr><td>test</td><td>integer</td><td>Set value of 1 to flag the test request. This can be done only when validating the integration.</td><td>no</td></tr><tr><td>bcat</td><td>string array</td><td>Blocked IAB categories for this impression.</td><td>no</td></tr><tr><td>bapp</td><td>string array</td><td>Block list of applications by their platform-specific, exchange-independent application identifiers. On Android, these are bundle or package names (such as “com.foo.mygame”); on iOS, these are numeric IDs. </td><td>no</td></tr><tr><td>badv</td><td>string array</td><td>Block list of advertisers by their top-level domains (for example, “ford.com”). </td><td>no</td></tr><tr><td>cur</td><td>string array</td><td>currency, only USD is allowed.</td><td>optional ; default USD</td></tr><tr><td>regs</td><td>object</td><td>An object that specifies any industry, legal, or governmental regulations in force for this request. Please see <a href="/pages/gtqRufdLdpjBO5RBesHu">Regs Object</a></td><td>yes for the subjected users</td></tr><tr><td>ext</td><td>object</td><td>please see <a href="/pages/WDXwRqeLbRCfrCvMunuW">Ext object</a></td><td>yes</td></tr></tbody></table>
