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 identities
      • POSTCreate an identity
      • GETGet an identity
      • PATCHUpdate an identity
      • DELRedact an identity
      • GETExport identity data (GDPR Art. 15 DSAR)
      • POSTSearch identities
      • GETList identity sessions
      • GETGet identity audit log
      • POSTAdd a tag
      • POSTRemove a tag
      • POSTSet tags
      • POSTPreview identity merge
      • POSTMerge identities
      • POSTArchive an identity
      • POSTRestore an archived identity
      • POSTPause continuous monitoring for an identity
      • POSTResume continuous monitoring for an identity
      • POSTAdvanced identity search
      • GETGet custom field values
      • PATCHSet custom field values
      • GETList identity relationships
      • POSTCreate an identity relationship
      • DELDelete an identity relationship
      • GETQuery identity relationship graph
      • GETFind cross-session image similarity matches
      • GETGet monitored lists for an identity
      • POSTAdd lists to identity monitoring
      • PUTReplace monitored lists for an identity
API ReferenceIdentities

Find cross-session image similarity matches

GET
https://devapi.withverifa.com/api/v1/identities/:identity_id/image-matches
GET
/api/v1/identities/:identity_id/image-matches
$curl https://devapi.withverifa.com/api/v1/identities/identity_id/image-matches \
>     -H "X-API-Key: <apiKey>"
1{
2  "data": [
3    {
4      "identity_id": "idn_def456",
5      "session_id": "ses_xyz789",
6      "similarity_score": 0.8234,
7      "matched_at": "2026-03-01T12:00:00Z",
8      "embedding_id": "facemb_abc123"
9    }
10  ],
11  "pagination": {
12    "total": 1,
13    "limit": 1,
14    "offset": 1
15  }
16}
Compares face embeddings stored for the given identity against all other embeddings in the organization. Returns identities with similar selfies or document photos, ranked by similarity score. This endpoint detects reused photos and documents across sessions — a key signal for synthetic identity fraud, document reuse, and fraud rings. Results are deduplicated by identity (keeping the highest similarity score when multiple embeddings match). Only matches above the specified threshold are returned.
Was this page helpful?
Previous

Get monitored lists for an identity

Next
Built with

Compares face embeddings stored for the given identity against all other embeddings in the organization. Returns identities with similar selfies or document photos, ranked by similarity score.

This endpoint detects reused photos and documents across sessions — a key signal for synthetic identity fraud, document reuse, and fraud rings.

Results are deduplicated by identity (keeping the highest similarity score when multiple embeddings match). Only matches above the specified threshold are returned.

Authentication

X-API-Keystring

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

Path parameters

identity_idstringRequired

Identity ID (idn_*) or external reference.

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:

Query parameters

thresholddoubleOptional

Minimum cosine similarity score (0.1–1.0) to count as a match. Default 0.6 balances precision vs recall. Use 0.8 for high-confidence matches only; use 0.4 for broader search with more false positives.

source_typeenumOptional

Filter by embedding source type. selfie matches selfie-to-selfie; document_front matches ID photo-to-ID photo. If omitted, all source types are compared.

Allowed values:
limitintegerOptional1-100Defaults to 20
Maximum number of matches to return.
offsetintegerOptional>=0Defaults to 0
Offset for pagination.

Response

Paginated list of image similarity matches.
datalist of objects
paginationobject

Errors

401
Unauthorized Error
404
Not Found Error