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:

https://api.250ok.com/api/1.0/reputationinformant/dmarc/reportsources

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
  },
  {
    "organization": "FastMail Pty Ltd",
    "count": 75,
    "pct": 0
  },
  {
    "organization": "Mail.Ru",
    "count": 68,
    "pct": 0
  },
  {
    "organization": "TDC.dk",
    "count": 20,
    "pct": 0
  },
  {
    "organization": "163.com",
    "count": 6,
    "pct": 0
  },
  {
    "organization": "yeah.net",
    "count": 3,
    "pct": 0
  },
  {
    "organization": "vodafone.it",
    "count": 2,
    "pct": 0
  }
]

Parameters

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.