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
      • GETGet custom list matches for a session
      • GETList custom lists
      • POSTCreate a custom list
      • GETGet a custom list
      • PATCHUpdate a custom list
      • POSTArchive a custom list
      • GETList items in a custom list
      • POSTAdd an item to a custom list
      • GETGet a list item
      • DELDelete a list item
      • POSTBulk add items to a list
      • POSTImport items from CSV
      • GETExport items as CSV
      • POSTCheck a subject against custom lists
      • POSTMark a list match as false positive
API ReferenceLists

Mark a list match as false positive

POST
https://devapi.withverifa.com/api/v1/list-matches/:match_id/false-positive
POST
/api/v1/list-matches/:match_id/false-positive
$curl -X POST https://devapi.withverifa.com/api/v1/list-matches/match_id/false-positive \
>     -H "X-API-Key: <apiKey>" \
>     -H "Content-Type: application/json" \
>     -d '{}'
1{
2  "id": "string",
3  "org_id": "string",
4  "list_id": "string",
5  "match_type": "string",
6  "match_score": 1.1,
7  "is_false_positive": true,
8  "created_at": "2024-01-15T09:30:00Z",
9  "session_id": "string",
10  "identity_id": "string",
11  "list_item_id": "string",
12  "list_type": "string",
13  "match_details": {},
14  "workflow_run_id": "string",
15  "resolved_by": "string",
16  "resolved_at": "2024-01-15T09:30:00Z",
17  "resolution_notes": "string"
18}
Was this page helpful?
Previous

List audit findings

Next
Built with

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 null
identity_idstring or null
list_item_idstring or null
list_typestring
match_detailsmap from strings to any or null
workflow_run_idstring or null
resolved_bystring or null
resolved_atdatetime or null
resolution_notesstring or null

Errors

401
Unauthorized Error
404
Not Found Error