API Guide







Spam Trap Summary

The Spam Trap Summary provides a summary of trap hits statified in various ways. 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/trapsummary

Sample Output:

[
    {
        "day": "2015-01-23",
        "count": "151"
    },
    {
        "day": "2015-01-24",
        "count": "108"
    },
    {
        "day": "2015-01-25",
        "count": "81"
    },
    {
        "day": "2015-01-26",
        "count": "122"
    }
]
                

Parameters

Parameter Description Acceptable Values Required
id The reputation profile ID Integer Y
type How the trap data should be stratified. subject, ip, date, domain, fromaddress, dkim, spf 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
You must specify a profile ID. 404 A profile ID was not detected in the request.
Profile does not exist. 404 We couldn't find a profile matching the specified ID.
Invalid start date format. 404 The start date provided was submitted in an invalid format
Invalid end date format. 404 The end date provided was submitted in an invalid format
No results found. 404 We couldn't find any results matching your criteria.