Ask the other institution to review a match

Asks the other organization involved in this match to review its own side and record a determination. Face images are never shared between consortium members, so when a human needs a second opinion on a borderline match (a near-threshold similarity, a suspected sibling or twin) this moves the *question* rather than the applicant's photo: the peer looks at the record it already holds, and only their investigation status crosses the organization boundary. Idempotent for 24 hours — re-requesting while a request is still outstanding returns `already_pending` and does not re-notify the peer. The pending state is visible on the match as `peer_investigation.review_requested_at`.

Authentication

X-API-Keystring

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

Path parameters

consortium_idstringRequired
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.

Key-InflectionenumOptionalDefaults to snake

Response key casing. Defaults to snake.

Allowed values:

Response

Review requested, or a request was already pending.
statusenumOptional
match_idstringOptional
review_requested_atdatetime or nullOptional

Errors

401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
410
Gone Error