Errors
Error responses documented in the official API PDFs, grouped by audience. HTTP status codes and error codes are listed only when the PDF specifies them.
Publisher errors
Publisher APIsRTB Serving Engine errors use status: 0 and an error message. OpenRTB 2.5 errors use HTTP 400 and a JSON error object. HTTP 204 from OpenRTB is a no-bid, not an error.
The country code is required.
PublisherRequired-field error from the Publisher RTB Serving Engine when `cc` is missing.
The Brand Domain is required.
PublisherRequired-field error from the Publisher RTB Serving Engine when `bd` is missing.
Invalid Publisher Identity
PublisherHTTP 400 from OpenRTB 2.5 when the Publisher Identity is missing, contains characters other than letters, numbers, underscores, and hyphens, or is longer than 64 characters. The JSON error is "Invalid publisher key".
Invalid OpenRTB bid request
PublisherHTTP 400 from OpenRTB 2.5 when the body is not JSON, id is missing or blank, or the first impression has no id.
The keyword field is required.
PublisherAffiliate Product Search validation failure (HTTP 422) when keyword is missing.
Unauthorized
PublisherAffiliate Product Search authentication failure (HTTP 401).
Search failed.
PublisherAffiliate Product Search failure (HTTP 500).
Unauthorized
PublisherBrand List by Traffic Type authentication failure (HTTP 401) when AccessKey is missing or unknown.
The traffic_type parameter is required.
PublisherBrand List by Traffic Type validation failure (HTTP 400) when traffic_type is missing or blank.
Invalid traffic_type.
PublisherBrand List by Traffic Type validation failure (HTTP 400) when traffic_type is not an allowed name.
Platform errors
Platform APIsDocumented in the S2S Postback PDF. The endpoint returns HTTP 200 for these failures — always inspect message and error_code.
The given data was invalid.
PlatformPlatform S2S Postback validation failure (`error_code` 1) when required fields are missing or invalid.
error_code: 1
The access key is invalid.
PlatformPlatform S2S Postback validation failure (`error_code` 1) when the path `access_key` is invalid.
error_code: 1
something went wrong
PlatformPlatform S2S Postback processing / insert failure (`error_code` 2).
error_code: 2