API ReferenceChecks

Create multiple checks at once

Creates multiple screening checks for a single subject in one request.

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.

Idempotency-KeystringOptional<=255 characters

Unique key for idempotent requests. Cached for 24 hours. Sending the same key with different parameters returns 422.

Request

This endpoint expects an object.
external_refstringRequired
Your external reference for the subject.
check_typeslist of enumsOptional
List of check types to create.
enable_monitoringbooleanOptionalDefaults to false
Enable continuous monitoring for all checks.
name_firststringOptional

Subject’s first name. Required for AML checks (sanction, pep, adverse_media, warning).

name_laststringOptional
Subject's last name. Required for AML checks.
birthdatestringOptional

Date of birth in ISO 8601 format (YYYY-MM-DD). Improves AML match accuracy.

country_codestringOptional

ISO 3166-1 alpha-2 country code.

emailstringOptionalformat: "email"

Email address. Required for email_risk and email_risk_enhanced checks.

phonestringOptional

Phone number in E.164 format. Required for phone_risk and phone_risk_enhanced checks.

ip_addressstringOptional

IP address. Required for ip_risk checks.

addressobjectOptional

Structured address. Required for address_validation checks.

Response

Checks created.
datalist of objects

Errors

401
Unauthorized Error
422
Unprocessable Entity Error