Batches API: Results

Results represent completed Instant Criminal Search executions for subjects in a monitor (batch). Each entry summarizes one execution, including the subject, execution time, and number of records found.

Authentication

All requests require an API key passed as a Bearer token in the Authorization header:

Authorization: Bearer your-api-key

Response Conventions

Batch endpoints serialize numeric response values—including IDs, paging values, counts, durations, and birth-date components—as JSON strings. Date-time values use ISO-8601 local date-time format without a timezone suffix.

List Monitor Results

GET /batch/:id/results

Returns a paginated list of results for the specified monitor and authenticated account. Results are ordered by execution date and result ID, newest first.

Path Parameters

Parameter	Type	Description
id	Integer	Monitor ID

Query Parameters

Parameter	Type	Default	Description
page	Integer	1	Page number
pageSize	Integer	30	Records per page
startDate	Date	One week ago	Earliest execution date to include, in yyyy-MM-dd format
endDate	Date	Current date and time	Latest execution date to include, in yyyy-MM-dd format

When supplied, startDate includes the entire start day and endDate includes the entire end day.

Result Object

Each object in data combines the monitored subject with a single search execution.

Field	Type	Description
resultId	String (numeric)	Unique search execution identifier
searchId	String (numeric)	Subject/search identifier within the monitor
firstName	String | null	Subject first name
middleName	String | null	Subject middle name
lastName	String | null	Subject last name
birthYear	String (numeric) | null	Subject birth year
birthMonth	String (numeric) | null	Subject birth month
birthDay	String (numeric) | null	Subject birth day
resultCount	String (numeric)	Number of records found
executionTime	String (numeric) | null	Search execution time in milliseconds
resultDate	DateTime	When this search execution completed

Example Request

Curl

curl "https://api.infocusinfo.com/batch/101/results?page=1&pageSize=30&startDate=2026-03-01&endDate=2026-03-31" \
  -H "Authorization: Bearer your-api-key"

Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var request = HttpRequest.newBuilder(URI.create("https://api.infocusinfo.com/batch/101/results?page=1&pageSize=30&startDate=2026-03-01&endDate=2026-03-31"))
    .header("Authorization", "Bearer your-api-key")
    .GET()
    .build();

var response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode() + " " + response.body());

C#

using System.Net.Http;
using System.Text;

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Get, "https://api.infocusinfo.com/batch/101/results?page=1&pageSize=30&startDate=2026-03-01&endDate=2026-03-31");
request.Headers.Add("Authorization", "Bearer your-api-key");

using var response = await client.SendAsync(request);
Console.WriteLine($"{(int)response.StatusCode} {await response.Content.ReadAsStringAsync()}");

IntelliJ HTTP Client

GET https://api.infocusinfo.com/batch/101/results?page=1&pageSize=30&startDate=2026-03-01&endDate=2026-03-31
Authorization: Bearer your-api-key

Response

{
  "success": true,
  "paging": {
    "size": "30",
    "num": "1",
    "hasMore": false
  },
  "data": [
    {
      "searchId": "501",
      "firstName": "Jane",
      "middleName": null,
      "lastName": "Doe",
      "birthYear": "1990",
      "birthMonth": "8",
      "birthDay": "22",
      "resultDate": "2026-03-26T12:01:03",
      "executionTime": "842",
      "resultId": "9001",
      "resultCount": "3"
    }
  ]
}

Response Codes

Code	Description
200	Results returned successfully
400	Missing monitor ID, invalid date format, or startDate is after endDate
500	Server error

An invalid date range returns a JSON error with success: false and a message describing the validation failure.