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 checks
      • POSTCreate a check
      • POSTCreate multiple checks at once
      • GETGet check detail with hits
      • POSTDismiss AML hits
      • POSTRe-run check
      • POSTGDPR redact check PII
      • GETMonitoring history
      • POSTAdd tags
      • PUTSet tags (replace all)
      • DELRemove a tag
      • GETGenerate PDF report for a check
      • GETList checks for session
      • GETList checks for identity
      • GETList watchlists
      • GETGet a watchlist
      • GETList watchlist items
API ReferenceChecks

Get check detail with hits

GET
https://devapi.withverifa.com/api/v1/checks/:check_id
GET
/api/v1/checks/:check_id
$curl https://devapi.withverifa.com/api/v1/checks/check_id \
> -H "X-API-Key: <apiKey>"
1{
2 "id": "schk_abc123",
3 "check_type": "sanction",
4 "status": "pending",
5 "has_match": true,
6 "hit_count": 1,
7 "provider": "string",
8 "session_id": "string",
9 "identity_id": "string",
10 "external_ref": "string",
11 "monitoring_enabled": true,
12 "is_sandbox": true,
13 "tags": [
14 "string"
15 ],
16 "batch_id": "string",
17 "pep_risk_tier": "tier_1",
18 "pep_recommended_action": "string",
19 "redacted_at": "2024-01-15T09:30:00Z",
20 "last_checked_at": "2024-01-15T09:30:00Z",
21 "created_at": "2024-01-15T09:30:00Z",
22 "expires_at": "2024-01-15T09:30:00Z",
23 "result": {},
24 "hits": [
25 {
26 "id": "string",
27 "created_at": "2024-01-15T09:30:00Z",
28 "matched_name": "string",
29 "name_similarity": 1.1,
30 "dob_match": true,
31 "combined_score": 1.1,
32 "hit_source": "string",
33 "hit_type": "string",
34 "provider_ref": "string",
35 "deceased": true,
36 "is_false_positive": true,
37 "pep_details": {
38 "sources": [
39 "string"
40 ],
41 "positions": [
42 {
43 "title": "string",
44 "country": "string",
45 "from": "string",
46 "to": "string"
47 }
48 ],
49 "associates": [
50 {
51 "name": "string",
52 "relationship": "string"
53 }
54 ],
55 "pep_class": "string"
56 },
57 "sanction_details": {
58 "sources": [
59 "string"
60 ],
61 "list_name": "string",
62 "program": "string",
63 "listed_on": "string"
64 },
65 "adverse_media_details": {
66 "sources": [
67 {
68 "name": "string",
69 "url": "string",
70 "date": "string"
71 }
72 ]
73 }
74 }
75 ]
76}
Returns a single check with full detail including hits.
Was this page helpful?
Previous

Dismiss AML hits

Next
Built with

Authentication

X-API-Keystring

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

Path parameters

check_idstringRequired

Check ID (schk_*).

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

Check with hits.
idstring
check_typeenum

The type of check. Categories:

  • AML: sanction, pep, adverse_media, warning — screen against global sanctions, PEP, and adverse-media watchlists
  • Risk: email_risk, phone_risk, ip_risk — lightweight risk scoring
  • Enhanced: email_risk_enhanced, phone_risk_enhanced, address_validation, ssn_verification — deep provider-backed analysis
statusenum

Check status. pending = still processing, clear = no matches/low risk, hit = matches found or high risk, error = provider failure.

Allowed values:
has_matchboolean
Whether the check found any matches or flagged risk.
hit_countinteger

Number of screening hits found (AML checks) or 0/1 for risk checks.

providerstring or null

Sanitized provider category for the check (e.g., aml_screening, email_risk, phone_risk, address_verification). Raw vendor identifiers are scrubbed at the API boundary — the underlying vendor name is never exposed to API clients.

session_idstring or null
Associated session ID, if the check was triggered as part of a verification session.
identity_idstring or null
Associated identity ID, if the check is linked to a known identity.
external_refstring or null
Your external reference for the subject.
monitoring_enabledboolean

Whether ongoing monitoring is enabled for this check (AML only).

is_sandboxboolean

Whether this check was created in sandbox mode (uses test data).

tagslist of strings
Custom tags attached to this check.
batch_idstring or null
Batch ID if this check was created via the bulk endpoint.
pep_risk_tierenum

PEP risk classification tier. Only present for pep check type.

Allowed values:
pep_recommended_actionstring or null

Recommended action based on PEP risk tier. Only present for pep check type.

redacted_atdatetime or null

When check data was redacted (GDPR). Only present if redacted.

last_checked_atdatetime
created_atdatetime
expires_atdatetime
resultobject or null

Provider result data. Structure varies by check type:

  • AML: {match_count, highest_score, ...}
  • Risk: {risk_score, risk_level, deliverable, fraud_score, ...}
  • Enhanced: Provider-specific detailed analysis object
hitslist of objects

Screening hits (matches). Only included when fetching check detail.

Errors

401
Unauthorized Error
404
Not Found Error