API.
A small, predictable REST API to pull your DMARC data into your own tools, dashboards, or scripts. JSON in, JSON out, everything scoped to your organization.
Authentication
Create a key under Settings → API keys, then send it as a bearer token on every request:
curl https://dmarcula.com/api/v1/reports/aggregate/ \ -H "Authorization: Bearer YOUR_API_KEY"
Keep your key secret. It carries the same read access you have. API access is a plan feature, so if you get a permission error, check that it's enabled on your plan. Requests are subject to fair-use rate limits.
Endpoints
All paths are under the base https://dmarcula.com/api/v1/:
- /domains/
- Your monitored domains
- /reports/aggregate/
- Aggregate (RUA) reports
- /reports/failure/
- Failure (RUF) reports
- /alerts/
- Your alert configurations
The report endpoints are read-only; domains and alerts also accept management calls. Every endpoint returns only your organization's data. There's no way to see another tenant's.
Pagination
List endpoints are paginated at 50 items per page. Pass
?page=2 to step through, and follow the
next link in each response until it's null.
What's next
- Grab a key under Settings → API keys.
- Reading your dashboard: the same data, in the UI.