API Guide

DMARC Report Sources

Retrieves DMARC report mail volume for a domain, broken down by reporting organization, for a specified time period. Data is returned in the following formats: XML, JSON, CSV and Serialized.

Required headers: X-API-KEY
Optional headers: ACCEPT (json, xml, csv, serialized)
Method: GET

Endpoint URL:


Sample Output:

    "organization": "google.com",
    "count": 115651,
    "pct": 48.1
    "organization": "Yahoo! Inc.",
    "count": 65616,
    "pct": 27.3
    "organization": "Microsoft Corp.",
    "count": 38775,
    "pct": 16.1
    "organization": "AOL",
    "count": 12966,
    "pct": 5.4
    "organization": "comcast.net",
    "count": 6661,
    "pct": 2.8
    "organization": "emailsrvr.com",
    "count": 519,
    "pct": 0.2
    "organization": "qq.com",
    "count": 160,
    "pct": 0.1


Parameter Description Acceptable Values Required
domain Domain monitored (i.e. 250ok.com). String Y
startdate Starting date (defaults to 30 days ago). yyyy-mm-dd N
enddate Ending date (defaults to today). yyyy-mm-dd N
classification Specification of what type of DMARC record to report
(compliant, non-compliant, unauthenticated)
String N

Error Responses

Description Code Cause
Domain is required. 400 Please specify a domain for the query.
Bad or missing API key. 401 The X-API-KEY header was missing or contained an unrecognized/invalid key.
No results found. 404 There were results for the specified domain and date range.