search

Response example

hashtag
Sample Response

{
  "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": "<html><!-- ad markup --></html>",
          "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"
  }
}

hashtag
Response Structure

hashtag
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

hashtag
SeatBid Object

Field
Type
Description

seat

string

SSP/bidder identifier

bid

array

Array of bid objects

hashtag
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)

hashtag
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

hashtag
Video Response

For video bids, the response includes VAST XML in the cache:

hashtag
Native Response

For native bids, the adm field contains a JSON string with native assets:

hashtag
No Bid Response

When no bids are received, the response returns an empty seatbid array:

hashtag
Error Responses

hashtag
400 Bad Request

Returned when the request is malformed or missing required fields.

hashtag
204 No Content

Returned when the request is filtered (e.g., geo-filtering, IP filtering).

PreviousRequest exampleNextGoogle Ad Manager setup

Last updated

Was this helpful?