API Guide

DMARC Mail Breakdown by Domain

Retrieves all DMARC domains registered with and monitored by a user. 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/mailbreakdownbydomain

Sample Output:

[
    {
        "day": "2016-09-15",
        "rdnssubdomain": "nm21-vm6.bullet.mail.ne1.yahoo.com",
        "source_ip": "98.138.91.114",
        "count": 1,
        "dkim": "pass",
        "spf": "fail",
        "dkim_domain": "realpurity.com",
        "dkim_result": "pass",
        "spf_domain": "mail149.atl21.rsgsv.net",
        "spf_result": "neutral",
        "organization": "Microsoft Corp."
    },
    {
        "day": "2016-09-15",
        "rdnssubdomain": "nm7-vm4.bullet.mail.ne1.yahoo.com",
        "source_ip": "98.138.91.167",
        "count": 1,
        "dkim": "pass",
        "spf": "fail",
        "dkim_domain": "realpurity.com",
        "dkim_result": "pass",
        "spf_domain": "mail149.atl21.rsgsv.net",
        "spf_result": "neutral",
        "organization": "Microsoft Corp."
    }
]

Parameters

Parameter Description Acceptable Values Required
domain Sender domain String Y
rdnsdomain Sending IP reverse DNS domain String Y
classification Classification of DMARC record to report
(compliant, non-compliant, unauthenticated)
String Y
startdate Includes trap hits detected after the specified date. If unspecified, will default to 30 days prior. yyyy-mm-dd N
enddate Includes trap hits detected before the specified date. If unspecified, will default to the current date. yyyy-mm-dd N

Error Responses

Description Code Cause
Domain is required. 400 Please specify a domain for the query.
rdnsdomain is required. 400 Please specify a rdnsdomain for the query.
classification is required. 400 Please specify a classification (compliant, non-compliant, unauthenticated) 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 are no DMARC domains registered to the account.