Report API


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.18)

The API accepts both HTTPS POST and HTTPS GET.

For GET use the format:

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

CURL POST API call example:

$ curl -X POST -H Content-Type:application/x-www-form-urlencoded -d 'apikey=your_apikey'


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:[]=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:


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

Optional Marketing Append

You can add additional marketing data to the JSON response by using marketing=append

For example:[]=12345&marketing=append

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

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

Status Codes

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