Error
A valid request URL is required to generate request examples{
"statusCode": 401,
"message": "Unauthorized"
}
Closeout Events API
List Closeout Events
Query and poll the history of completed verification closeout events
GET
/
v1
/
closeout-events
Error
A valid request URL is required to generate request examples{
"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 reachedCOMPLETED 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
string
Filter to closeout events for a specific search ID.
string
Filter to a specific verification result ID.
string
ISO 8601 timestamp. Only returns events last updated on or after this time.
number
Maximum number of events to return. Defaults to
50, capped at 200.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
boolean
Always
true for a successful request.array
Array of closeout events, ordered by
updatedAt descending.Show Closeout Event Properties
Show Closeout Event Properties
string
Identifier for the event (the underlying verification result ID).
string
Timestamp the underlying verification result was last updated (ISO 8601).
string
Owning search identifier (UUID).
string
Verification result identifier (same value as
eventId).string
Always
"COMPLETED" — only completed searches produce closeout events.string
Generated human-readable summary of the closeout, e.g. search type and display name.
object
Detailed verification result.
Show verificationResult Properties
Show verificationResult Properties
string
Terminal outcome, e.g.
VERIFIED, NO_RECORD.string
Human-readable summary of findings.
object
Structured extracted verification data. May be
null.boolean
Whether a discrepancy was detected. May be
null.string
When the inbound result was submitted. May be
null.string
Result creation timestamp.
string
Result last-update timestamp.
object
Show Pagination Properties
Show Pagination Properties
number
Total number of completed closeout events matching your filters (ignores
cursor/limit).number
The effective limit applied to this request (after the 200 cap).
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.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
sinceorcursoras an alternative or backstop to webhooks. - Auditing: Retrieve the full closeout history for a specific
searchIdorverificationId.
Query Parameters
Filter by specific search ID
Filter by specific verification ID
ISO timestamp to filter events since (ISO string)
Maximum number of events to return (default 50, max 200)
Cursor for pagination
Response
200 - application/json
List of closeout events
The response is of type object.