Skip to main content
The Management API is a REST service for reporting and campaign operations. It is connected directly to the Adgentek database and is separate from the publisher ad-serving API (REST API integration) used to request ads at runtime. Use this API when you need to read campaign performance, create or update campaigns and line items, or automate workflows outside the dashboard.

​
Base URL

Production:
All versioned routes live under /v1/.... Unversioned metadata routes (/health, /version, /openapi.yaml) sit at the service root.

​
Authentication

Send your advertiser API key on every request:
Keys are org-scoped. Results include only data for the organization attached to the key. Each endpoint also requires a permission on the key: A key without the required permission returns 403 forbidden.

​
Response format

Successful responses wrap payloads in a data field. Errors use application/problem+json:
Every response includes version headers:

​
What you can do today

​
Campaign management

Write endpoints under /v1/advertiser/campaigns and /v1/advertiser/line-items support the full campaign lifecycle: create, validate, compose (campaign + line item in one call), update, duplicate, activate, and manage budgets, bids, targeting, and creatives. See Campaign management for the endpoint reference and examples.

​
Reporting

GET /v1/advertiser/reporting/campaigns returns aggregated impressions, clicks, spend, and derived KPIs from daily rollups. Filter by date range, campaign IDs, and breakdown (campaign or daily). See Advertiser reporting for parameters, metrics, and examples.
Creating a campaign requires a user_id in the request body. The API key identifies your organization, not a single user, so you must pass a user who belongs to that org. The service rejects a user_id outside your org with 403.

​
Machine-readable contract

The full OpenAPI 3.1 spec is served by the running API:
Use it for codegen, Postman import, or automated reference generation. Prefer the spec over hand-maintained endpoint tables when they diverge.

​
Health check

No authentication required:
Returns service status and whether the database connection is up. This API is not the publisher /get-ad endpoint. Publishers integrating ad delivery should use the REST API integration guide instead. For product context on campaigns and measurement, see Campaign setup and Measurement.