API ReferenceLists

Mark a list match as false positive

Authentication

X-API-Keystring

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

Path parameters

match_idstringRequired

Headers

Verifa-VersiondateOptional

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

Request

This endpoint expects an object.
notesstring or nullOptional
Optional notes explaining the false positive.

Response

Match marked as false positive.
idstring
org_idstring
list_idstring
match_typestring
match_scoredouble
is_false_positiveboolean
created_atdatetime
session_idstring or nullOptional
identity_idstring or nullOptional
list_item_idstring or nullOptional
list_typestringOptional
match_detailsmap from strings to any or nullOptional
workflow_run_idstring or nullOptional
resolved_bystring or nullOptional
resolved_atdatetime or nullOptional
resolution_notesstring or nullOptional

Errors

401
Unauthorized Error
404
Not Found Error