For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
  • Getting Started
    • Introduction
    • How Verifa Works
    • Quickstart
    • Choosing an Integration Method
  • Use Cases
    • KYC Onboarding
    • Age Verification
    • AML Compliance
    • Fraud Prevention
    • Marketplace Trust & Safety
  • Core Concepts
    • Overview
    • Sessions
    • Verifications & Checks
    • Workflows
    • Identities
    • Cases
    • Screening & Reports
    • Lists
  • Integration Guides
    • Overview
    • JavaScript SDK
    • Web Capture Flow
    • API-Only Integration
    • Mobile SDK
    • Webhooks Guide
    • MCP Server
    • Migrating from Persona
  • API Details
    • Overview
    • Authentication
    • Pagination
    • Rate Limiting
    • Versioning
    • Errors
    • Webhooks
    • Idempotency
    • Key Inflection
    • Data Access
    • Data Retention
  • Tutorials
    • Creating Your First Verification Session
    • Creating a Workflow
    • Receiving Webhooks & Validating Signatures
    • Handling Webhook Events
    • Custom Document Types & AI Extraction
  • Best Practices
    • Testing
    • Preventing Duplicates
    • Fraud Signals
    • Changelog
  • API Reference
      • GETList review cases
      • POSTCreate a review case
      • GETGet a review case
      • PATCHUpdate case metadata
      • POSTClaim a case
      • POSTRelease a claim
      • POSTAssign a case
      • POSTApprove a case
      • POSTReject a case
      • POSTCreate a demo review case (sandbox only)
      • GETGet case counts by tab
      • POSTClaim the next unassigned case
      • POSTEscalate a case
      • PUTUpdate extracted PII on a case result
      • GETList notes on a case
      • POSTAdd a note to a case
      • POSTSearch cases with advanced filters
      • GETList distinct case tags
      • POSTOverride a verification check on a case
API ReferenceCases

Override a verification check on a case

POST
https://devapi.withverifa.com/api/v1/cases/:case_id/override/:policy
POST
/api/v1/cases/:case_id/override/:policy
$curl -X POST https://devapi.withverifa.com/api/v1/cases/case_id/override/policy \
> -H "X-API-Key: <apiKey>" \
> -H "Content-Type: application/json" \
> -d '{}'
1{
2 "case_id": "string",
3 "policy": "string",
4 "status": "processing"
5}

Overrides the result of a specific verification check on the session associated with this case, then re-runs the workflow to update the overall decision. Returns 202 — processing is async.

Was this page helpful?
Previous

List API keys

Next
Built with

Authentication

X-API-Keystring

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

Path parameters

case_idstringRequired
policystringRequired

The verification policy to override (e.g. face_match).

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.
passedbooleanOptional
Whether the check should be marked as passed.
reasonstring or nullOptional
Reason for the override.

Response

Override accepted, workflow re-processing.

case_idstring
policystring
statusstring

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error
422
Unprocessable Entity Error