API Guide







Get DMARC Entries

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/entries

Sample Output:

[
    {
        "day": "2016-09-22",
        "domain": "250ok.com",
        "rdnsdomain": "",
        "rdns": "",
        "id": 131647734,
        "source_ip": "152.166.119.1",
        "count": 1,
        "disposition": "none",
        "dkim": "fail",
        "spf": "fail",
        "type": "",
        "comment": "",
        "envelope_to": null,
        "envelope_from": null,
        "header_from": "250ok.com",
        "dkim_domain": "",
        "dkim_selector": "",
        "dkim_result": "",
        "dkim_hresult": null,
        "spf_domain": "250ok.com",
        "spf_scope": null,
        "spf_result": "softfail",
        "organization": "google.com"
    }
]

Parameters

Parameter Description Acceptable Values Required
domain Sending domain string Y
spfresult Types of entries to return for SPF none, pass, fail, neutral, softfail, temperror, permerror N
dkimresult Types of entries to return for DKIM none, pass, fail, neutral, policy, temperror, permerror N
classification Types of entries to return compliant, non-compliant, unauthenticated N
startdate Includes entries detected after the specified date. If unspecified, will default to 30 days prior. yyyy-mm-dd N
enddate Includes entries before the specified date. If unspecified, will default to the current date. yyyy-mm-dd N

Error Responses

Description Code Cause
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.