Report API

Overview

Use the Report API to grab the JSON responses from previous API Vetting calls made within the last 35 days. This can be used to add scoring and risk hit meta-data to other systems such Hadoop, Tableau, and Splunk.

Endpoint (5.8)

https://feed-api.ehawk.net/report/

The API accepts both HTTPS POST and HTTPS GET.

For GET use the format:

https://feed-api.ehawk.net/report/function/?keyword=value

When using POST, make sure to have Content-Type: application/x-www-form-urlencoded

CRUL POST API call example:

$ curl -X POST -H Content-Type:application/x-www-form-urlencoded -d 'apikey=your_apikey' https://feed-api.ehawk.net/report/function/

Function

Options for function

Select the data type using function values:

data search for items matching username lead_id transaction_id

Send up to 100 combinations of lead_id/username/transaction_id name/value pairs. Use []= to create array with multiple items. GET example for two lead_ids:

https://feed-api.ehawk.net/report/data?apikey=your_apikey&lead_id[]=10&lead_id[]=12

date Start report at specific time using start or start_epoch

Send start timestamp in format of UTC string without timezone: 2017-06-23 19:54:23, or start_epoch in Unix timestamp: 1498247663. For example:

https://feed-api.ehawk.net/report/campaign?apikey=your_apikey&start=2017-06-23%2019:54:23

Response

The report is returned as a JSON with a maximum of 500 items/rows in the format:

Optional Paging

Report API calls are limited to 500 rows. Use optional paging commands to page through large data sets.

page Default page starts at 1. Increase for each additional block of records. For example, for page 10

https://feed-api.ehawk.net/report/date?apikey=your_apikey&start=2017-06-23%2019:54:23&page=10

num number of records returned. Default is 100 and max is 500.

https://feed-api.ehawk.net/report/date?apikey=your_apikey&start=2017-06-23%2019:54:23&page=10&num=500

Status Codes

Status Response
200 OK (no errors)
502 Invalid APIKEY or URL