api
Native Ad Server API
Build native ads into your web page or app
dvr
Sponsored Listings API
Let sellers promote their product at the top of the list
grid_view
Promoted Content API
Add promoted content based on search queries or keywords
desktop_windows
Digital-Out-Of-Home (DOOH) API
Reach out of home audiences on screens or billboards
campaign
Internal Promotions API
Offer users vouchers or promo codes at the right time
api
Decision API
Returns a JSON response with ads
api
Management API
Manage campaigns and inventory
api
Reports API
Custom reports and data shipping
monitor_heart
API Status
Live network infrastructure status
AdFlight.io Logo
AdFlight.io
Ad Server APIs for Developers
topic Getting Started
Authentication
Error Handling
api Decision API
Ad Request
Ad Response
Logging Events
api Management API
Channels
Zones
Advertisers
Campaigns
Creatives
api Reporting API
Reports

Error Handling

Conventional HTTP response codes are used to indicate if a request failed or was successful. Codes in the 2xx range indicate success. Codes in the 4xx range indicate that the request failed. In that case, the JSON response will hold an error code and human-readable error message.
authentication_error
string, solvable
The X-ApiKey header was not added or the key was incorrect. Contact support if you need help.
invalid_endpoint
string, solvable
An incorrect endpoint URL was used. Check for typos and make sure to use the endpoints from this documentation.
payload_error
string, solvable
The payload contained missing parameters or had an incorrect format. See the error message for details.
quota_error
string, solvable
Your monthly quota limit has been reached. Get in touch if you need a higher quota.
processing_error
string, not solvable
The worker nodes weren't able to process your request. Please contact support to see if the issue can be fixed.
Example of an error
{
    "error_type": "payload_error",
    "message": "There was an error."
}