API ReferenceIdentities

Advanced identity search

Search identities using complex filter operators. Supports AND/OR mode with operators like eq, neq, contains, starts_with, between, gt, lt, gte, lte, in_list. PII fields use HMAC hash comparison (eq only).

Authentication

X-API-Keystring

Organization API key. Keys are prefixed with vk_live_ (production) or vk_sandbox_ (sandbox).

Headers

Verifa-VersiondateOptional

API version date string (e.g. 2026-02-01). If omitted, the version pinned to your API key is used.

Key-InflectionenumOptionalDefaults to snake

Response key casing. Defaults to snake.

Allowed values:

Request

This endpoint expects an object.
modeenumOptionalDefaults to all

“all” requires all filters to match (AND), “any” requires at least one (OR).

Allowed values:
filterslist of objectsOptional
limitintegerOptional<=100Defaults to 25
offsetintegerOptionalDefaults to 0

Response

Search results.
datalist of objects
paginationobject

Errors

401
Unauthorized Error
422
Unprocessable Entity Error