API Guide

Get Blacklisted Items History

Blacklisted Items (History) provides a data set of items that were previously blacklisted. 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/blacklistinformant/blacklisthistory

Sample Output:

                [
                    {
                        "blacklisted_time": "06-02-2014 16:40 EST",
                        "resolve_time": "06-03-2014 15:40 EST",
                        "blacklisted_item": "168430085",
                        "monitor_range": "",
                        "monitor_type": "ip",
                        "rbl_server": "250ok IP Test",
                        "rbl_list": "IP test",
                        "rbl_url": "http://www.250ok.com",
                        "profile_id": 1
                    },
                    {
                        "blacklisted_time": "06-02-2014 16:40 EST",
                        "resolve_time": "06-03-2014 15:40 EST",
                        "blacklisted_item": "168430085",
                        "monitor_range": "",
                        "monitor_type": "ip",
                        "rbl_server": "250ok IP Test",
                        "rbl_list": "IP test",
                        "rbl_url": "http://www.250ok.com",
                        "profile_id": 2
                    }
                ]
            

Parameters

Parameter Description Acceptable Values Required
profile_id The unique identifier of the profile. NOTE: Profile IDs can be retrieved by executing the Profile Summary API call. Integer Y
startdate Returns items blacklisted on or after the specified date. yyyy-mm-dd N
enddate Returns items blacklisted on or before the specified date. yyyy-mm-dd N
daterange Returns items that have been blacklisted within the following time frames: Last day, Last 7 days, Last 30 days, Last 90 days. l1, l7, l30, l90 N
includecurrent Include currently listed items in addition to resolved items (default is 0). 0,1 N
groupbyitem Groups results by item. 0,1 N

Error Responses

Description Code Cause
Invalid profile ID. 404 The unique identifier of the profile is empty or invalid.
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
Invalid date range format. 404 The date range provided was submitted in an invalid format
No results found. 404 We couldn't find any results matching your criteria.