API Guide







Get Complaints

The Get Complaints endpoint provides information for each individual complaint collected by 250ok Reputation. 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/complaints

Sample Output:

{
    "total": 200,
    "complaints": [
        {
            "id": "0000111122223333",
            "date": "2017-04-20 00:41:22",
            "provider": "Yahoo",
            "ip": "127.0.0.1",
            "rdns": "mta.yourdomain.com",
            "fromaddress": "you@domain.com",
            "fromdomain": "domain.com",
            "toaddress": "recipient@yahoo.com",
            "todomain": "yahoo.com",
            "subject": "Some subject line...",
            "messagesample_id": "aaaabbbbccccdddd"
        },...
    ]
}
                

Parameters

Parameter Description Acceptable Values Required
startdate Includes trap hits detected after the specified date (or 24-hour UTC datetime). If unspecified, will default to 30 days prior. yyyy-mm-dd
or
yyyy-mm-dd hh:ii:ss
N
enddate Includes trap hits detected before the specified date (or 24-hour UTC datetime). If unspecified, will default to the current date. yyyy-mm-dd
or
yyyy-mm-dd hh:ii:ss
N

Error Responses

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