API ReferenceCases

Reject a case

Rejects a case. If the organization has dual review enabled, the first call submits a recommendation and the second call (by a different reviewer) finalizes the decision.

Required scope: cases:decide (or legacy cases:write).

Authentication

X-API-Keystring

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

Path parameters

case_idstringRequired

Request

This endpoint expects an object.
reviewer_idstringRequired
Org user public ID or UUID of the reviewer making the decision.
notesstring or nullOptional
Optional notes for the review decision.
rejection_reasonstring or nullOptional

Reason for rejection (only for reject action).

rejection_reason_codeenumOptional

Structured reason a verification was rejected. Complements the free-text rejection_reason. Stable enum — clients can pivot UI and metrics off this without parsing prose.

block_future_attemptsbooleanOptionalDefaults to false

When true, adds this session’s document, device, and face identifiers to the organization’s blocklist. Future verification sessions presenting the same identifiers will be flagged or hard-blocked.

Response

Case rejected or recommendation submitted.
idstring
Case public ID.
session_idstring
UUID of the associated session.
statusenum
created_atdatetime
decisionenum
assigned_tostring or null
UUID of the assigned reviewer.
claimed_atdatetime or null
entered_review_atdatetime or null
decided_atdatetime or null

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error
409
Conflict Error