API Guide

IP History

Retrieves DMARC history for the specified IP address and date range. 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/iphistory

Sample Output:

{
  "meta": [
    {
      "source_ip": "198.104.131.166",
      "rdns": "outbound.shareasale.com",
      "country": "US",
      "stateprov": "Colorado",
      "city": "Greenwood Village",
      "latitude": 39.6051,
      "longitude": -104.892,
      "isp_name": "NTT America",
      "connection_type": null,
      "organization_name": "NTT America, Inc.",
      "count": 10
    }
  ],
  "dayoverview": {
    "2016-08-30": {
      "non-compliant": 1
    },
    "2016-08-31": {
      "non-compliant": 1
    },
    "2016-09-09": {
      "non-compliant": 2
    },
    "2016-09-11": {
      "non-compliant": 1
    },
    "2016-09-15": {
      "non-compliant": 2
    },
    "2016-09-20": {
      "non-compliant": 1
    },
    "2016-09-21": {
      "non-compliant": 1
    },
    "2016-09-23": {
      "non-compliant": 1
    }
  },
  "overview": {
    "compliant": 0,
    "non-compliant": 10,
    "unauthenticated": 0
  },
  "failure": [],
  "auth": [
    {
      "spf_result": "pass",
      "spf": "fail",
      "dkim_result": "",
      "dkim": "fail",
      "count": 6
    },
    {
      "spf_result": "pass",
      "spf": "fail",
      "dkim_result": "neutral",
      "dkim": "fail",
      "count": 3
    },
    {
      "spf_result": "pass",
      "spf": "fail",
      "dkim_result": "none",
      "dkim": "fail",
      "count": 1
    }
  ]
}                

Parameters

Parameter Description Acceptable Values Required
domain Sender domain String Y
ip IP address of mail sender 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
includefailures Includes metadata on forensic reports from DMARC failures y, n (defaults to n) N

Error Responses

Description Code Cause
Domain is required. 400 Please specify a domain for the query.
IP is required. 400 Please specify an IP address 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.