API Reference
API v1 reference
API v1 defines the request and response contracts used by REST, Script Tag, and the SDK.
Base URL
Use https://api.wavebird.ai for production requests. Endpoint paths begin with /v1. Local backend tests generally use http://127.0.0.1:3300; this is not a public service URL.
Request and delivery paths
Use /v1/placements to request an ad and /v1/render.js to render a filled response. Browser activation supplies the token for browser-authorized requests. Jobs and decisions expose the advanced lifecycle.
Compatibility and endpoint status
Check each endpoint for its authentication and stability requirements. An API version does not imply that every endpoint has the same stability status.
Need help with your integration?
Share the affected endpoint, request ID, and the behavior you expected. Leave out keys and user content.