API Reference

API v1 reference

API v1 defines the shared REST contract behind the language packages, Script Tag and direct integrations.

Base URL

Use https://api.wavebird.ai. Endpoint paths begin with /v1. Test, dry-run and approved Live behavior are determined by the credential and project, not by a different public API host.

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.

Browse all endpoints →Make the first request →

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.

Endpoint status →Versioning policy →Migration guide →

Need help with your integration?

Share the affected endpoint, request ID, and the behavior you expected. Leave out keys and user content.

Contact the team