Get closeout events

curl --request GET \
  --url https://sandbox.theary.ai/v1/closeout-events \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://sandbox.theary.ai/v1/closeout-events"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://sandbox.theary.ai/v1/closeout-events', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://sandbox.theary.ai/v1/closeout-events",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://sandbox.theary.ai/v1/closeout-events"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://sandbox.theary.ai/v1/closeout-events")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://sandbox.theary.ai/v1/closeout-events")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "statusCode": 401,
  "message": "Unauthorized"
}

GET

closeout-events

Get closeout events

curl --request GET \
  --url https://sandbox.theary.ai/v1/closeout-events \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://sandbox.theary.ai/v1/closeout-events"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://sandbox.theary.ai/v1/closeout-events', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://sandbox.theary.ai/v1/closeout-events",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://sandbox.theary.ai/v1/closeout-events"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://sandbox.theary.ai/v1/closeout-events")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://sandbox.theary.ai/v1/closeout-events")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "statusCode": 401,
  "message": "Unauthorized"
}

List Closeout Events

Not to be confused with Closeout endpoint configuration, which configures where closeout webhooks are sent — this endpoint lets you query/poll closeout event history after the fact. Returns verification results for searches that have reached COMPLETED status, with cursor-based pagination and optional filtering. Useful for polling or reconciling closeout activity instead of (or in addition to) relying on webhooks.

This route intentionally lives under the shorter /v1/ prefix rather than /background-check/v1/ — it is a general audit/polling API, not a background-check-specific route. See API versioning.

Request

searchId

string

Filter to closeout events for a specific search ID.

verificationId

string

Filter to a specific verification result ID.

since

string

ISO 8601 timestamp. Only returns events last updated on or after this time.

limit

number

Maximum number of events to return. Defaults to 50, capped at 200.

cursor

string

Opaque cursor for pagination — pass the last eventId from a previous page to fetch the next page.

Prefer either verificationId or cursor for a given request. When both are supplied, the server uses the cursor pagination filter and may not apply verificationId as a separate filter.

Response

success

boolean

Always true for a successful request.

data

array

Array of closeout events, ordered by updatedAt descending.

Show Closeout Event Properties

eventId

string

Identifier for the event (the underlying verification result ID).

occurredAt

string

Timestamp the underlying verification result was last updated (ISO 8601).

searchId

string

Owning search identifier (UUID).

verificationId

string

Verification result identifier (same value as eventId).

status

string

Always "COMPLETED" — only completed searches produce closeout events.

summary

string

Generated human-readable summary of the closeout, e.g. search type and display name.

verificationResult

object

Detailed verification result.

Show verificationResult Properties

outcome

string

Terminal outcome, e.g. VERIFIED, NO_RECORD.

resultDetails

string

Human-readable summary of findings.

fullVerification

object

Structured extracted verification data. May be null.

discrepancy

boolean

Whether a discrepancy was detected. May be null.

submittedAt

string

When the inbound result was submitted. May be null.

createdAt

string

Result creation timestamp.

updatedAt

string

Result last-update timestamp.

pagination

object

Show Pagination Properties

total

number

Total number of completed closeout events matching your filters (ignores cursor/limit).

limit

number

The effective limit applied to this request (after the 200 cap).

offset

number

0 when paginating by page (no cursor supplied). Omitted from the response entirely when a cursor is supplied, since cursor-based pagination doesn’t use offsets.

hasMore

boolean

Whether more events exist beyond this page.

Example Request

curl -sS -X GET "https://sandbox.theary.ai/v1/closeout-events?limit=50" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Accept: application/json"

const response = await fetch('https://sandbox.theary.ai/v1/closeout-events?limit=50', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer YOUR_JWT_TOKEN',
    'Content-Type': 'application/json',
  },
})

const result = await response.json()

import requests

response = requests.get(
    'https://sandbox.theary.ai/v1/closeout-events',
    params={'limit': 50},
    headers={
        'Authorization': 'Bearer YOUR_JWT_TOKEN',
        'Content-Type': 'application/json',
    },
)

result = response.json()

Example Response

{
  "success": true,
  "data": [
    {
      "eventId": "123e4567-e89b-12d3-a456-426614174004",
      "occurredAt": "2026-01-16T15:00:00.000Z",
      "searchId": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
      "verificationId": "123e4567-e89b-12d3-a456-426614174004",
      "status": "COMPLETED",
      "summary": "employment verification completed for Acme Corp - Status: Completed",
      "verificationResult": {
        "outcome": "VERIFIED",
        "resultDetails": "Employment verified: John Smith worked as Senior Software Engineer at Acme Corp from 2020-01-15 to 2023-06-30.",
        "fullVerification": { "position": "Senior Software Engineer", "salaryConfirmed": true },
        "discrepancy": false,
        "submittedAt": "2026-01-16T15:00:00.000Z",
        "createdAt": "2026-01-16T15:00:00.000Z",
        "updatedAt": "2026-01-16T15:00:00.000Z"
      }
    }
  ],
  "pagination": {
    "total": 1,
    "limit": 50,
    "offset": 0,
    "hasMore": false
  }
}

Error Responses

{
  "statusCode": 401,
  "message": "Unauthorized"
}

Use Cases

Polling/reconciliation: Periodically poll for newly completed closeouts using since or cursor as an alternative or backstop to webhooks.
Auditing: Retrieve the full closeout history for a specific searchId or verificationId.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

searchId

string

Filter by specific search ID

verificationId

string

Filter by specific verification ID

since

string

ISO timestamp to filter events since (ISO string)

limit

number

Maximum number of events to return (default 50, max 200)

cursor

string

Cursor for pagination

Response

200 - application/json

List of closeout events

The response is of type object.

Generate Upload URL Verification request

Overview

Orders API

Batches API

Inbound API

Files API

Closeout Events API

Request and order schemas

Webhook schemas

List Closeout Events

List Closeout Events

Request

Response

Example Request

Example Response

Error Responses

Use Cases

Authorizations

Query Parameters

Response

​List Closeout Events

​Request

​Response

​Example Request

​Example Response

​Error Responses

​Use Cases

Authorizations

Query Parameters

Response

List Closeout Events

Request

Response

Example Request

Example Response

Error Responses

Use Cases