API Access
Everything the dashboard does goes through the MailAdx REST API, and the same API is available to your own scripts with an account API key.
Authentication
Create a key under Settings → API Keys and send it as a bearer token. A key acts as the user who created it — same accounts, same permission level, same data isolation. It is shown once; only a hash is stored. Keys can expire and can be revoked at any time.
curl "https://mailadx.com/api/v1/reports/delivery?startDate=2026-09-01&endDate=2026-09-30" \ -H "Authorization: Bearer mlx_live_…"
Commonly used endpoints
| What | Endpoint |
|---|---|
| Ad units (publishers) | GET/POST /api/v1/ssp/ad-units |
| Orders, line items, creatives (advertisers, publishers' direct-sold) | /api/v1/dsp/orders, /api/v1/dsp/line-items, /api/v1/dsp/creatives |
| Delivery report (date range) | GET /api/v1/reports/delivery?startDate=&endDate= |
| Breakdown by line item, creative, ad unit, publisher, geo, device | GET /api/v1/reports/delivery/breakdown?startDate=&endDate=&groupBy= |
| Statement / invoice (CSV or JSON) | GET /api/v1/billing/invoice?type=&entityId=&startDate=&endDate=&format= |
| Wallet balance and transactions | GET /api/v1/wallet, GET /api/v1/wallet/transactions |
| Audience demographics upload (publishers) | POST /api/v1/audience/enrich/{publisherId} (CSV) |
| Tag Health (publishers) | GET /api/v1/publisher/serving-stats?range=7d |
Requests are scoped to the account in the key owner's session; anything outside it returns 403. Report endpoints take dates as yyyy-MM-dd; money fields ending in Micros are millionths of a US dollar.
What is not available
There are no webhooks, no separate partner-specific endpoints and no published rate-limit tiers. If you are building an integration, email support@mailadx.com with what you need.