# Response example ## Sample Response ```json { "id": "92ca2c72-53c0-4552-be3c-7559398564cb", "cur": "USD", "seatbid": [ { "seat": "triplelift", "bid": [ { "id": "bid-12345", "impid": "92ca2c72-53c0-4552-be3c-7559398564cb", "price": 1.78, "adomain": ["advertiser.com"], "crid": "creative-123", "w": 320, "h": 480, "adm": "", "ext": { "mediaType": "banner", "tagId": "testnexx", "ssp": "triplelift", "prebid": { "type": "banner", "targeting": { "hb_env": "mobile-app", "hb_cache_id": "e18e97c5-dbba-416c-8df6-2c082b113f25", "hb_pb": "1.78", "hb_cache_path": "/cache", "hb_size": "320x480", "hb_bidder": "triplelift", "hb_partner": "nexx360", "hb_cache_host": "fast.nexx360.io", "hb_format": "banner" }, "cache": { "bids": { "url": "https://fast.nexx360.io/cache?uuid=e18e97c5-dbba-416c-8df6-2c082b113f25", "cacheId": "e18e97c5-dbba-416c-8df6-2c082b113f25" } } } } } ] } ], "ext": { "version": "1.0.0" } } ``` ## Response Structure ### Root Level | Field | Type | Description | | --------- | ------ | -------------------------------- | | `id` | string | Request ID (echoed from request) | | `cur` | string | Currency code (USD, EUR, etc.) | | `seatbid` | array | Array of seat bids | | `ext` | object | Extension object with metadata | ### SeatBid Object | Field | Type | Description | | ------ | ------ | --------------------- | | `seat` | string | SSP/bidder identifier | | `bid` | array | Array of bid objects | ### Bid Object | Field | Type | Description | | --------- | ------- | -------------------------------- | | `id` | string | Unique bid identifier | | `impid` | string | Impression ID (links to request) | | `price` | number | Bid price (CPM) | | `adomain` | array | Advertiser domains | | `crid` | string | Creative ID | | `w` | integer | Creative width | | `h` | integer | Creative height | | `dealid` | string | Deal ID (if applicable) | | `adm` | string | Ad markup (HTML/VAST/JSON) | ### Bid Extension (ext.prebid) | Field | Type | Description | | ----------- | ------ | ----------------------------------- | | `type` | string | Media type (banner, video, native) | | `targeting` | object | Prebid targeting keys for ad server | | `cache` | object | Cache information for ad retrieval | ## Video Response For video bids, the response includes VAST XML in the cache: ```json { "id": "video-request-id", "cur": "USD", "seatbid": [ { "seat": "rubicon", "bid": [ { "id": "video-bid-123", "impid": "video-imp-id", "price": 5.50, "adomain": ["videoadvertiser.com"], "crid": "video-creative-456", "w": 320, "h": 480, "ext": { "mediaType": "video", "prebid": { "type": "video", "targeting": { "hb_env": "mobile-app", "hb_cache_id": "vast-uuid-12345", "hb_pb": "5.50", "hb_cache_path": "/cache", "hb_size": "320x480", "hb_bidder": "rubicon", "hb_partner": "nexx360", "hb_cache_host": "fast.nexx360.io", "hb_format": "video" }, "cache": { "vastXml": { "url": "https://fast.nexx360.io/cache?uuid=vast-uuid-12345", "cacheId": "vast-uuid-12345" } } } } } ] } ] } ``` ## Native Response For native bids, the `adm` field contains a JSON string with native assets: ```json { "id": "native-request-id", "cur": "USD", "seatbid": [ { "seat": "appnexus", "bid": [ { "id": "native-bid-789", "impid": "native-imp-id", "price": 2.25, "adomain": ["nativeadvertiser.com"], "crid": "native-creative-101", "adm": "{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"title\":{\"text\":\"Ad Title\"}},{\"id\":2,\"img\":{\"url\":\"https://example.com/image.jpg\",\"w\":300,\"h\":250}}],\"link\":{\"url\":\"https://click.example.com\"}}", "ext": { "mediaType": "native", "prebid": { "type": "native", "targeting": { "hb_env": "mobile-app", "hb_cache_id": "native-uuid-789", "hb_pb": "2.25", "hb_bidder": "appnexus", "hb_partner": "nexx360", "hb_cache_host": "fast.nexx360.io", "hb_format": "native" } } } } ] } ] } ``` ## No Bid Response When no bids are received, the response returns an empty seatbid array: ```json { "id": "92ca2c72-53c0-4552-be3c-7559398564cb", "cur": "USD", "seatbid": [], "ext": { "version": "1.0.0" } } ``` ## Error Responses ### 400 Bad Request Returned when the request is malformed or missing required fields. ### 204 No Content Returned when the request is filtered (e.g., geo-filtering, IP filtering). --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://developer.nexx360.io/integration-methods/inapp/response-example.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.