Response example

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"
  }
}

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:

Native Response

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

No Bid Response

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

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

Last updated

Was this helpful?