F
@fincheck Verified

KYC Identity Verification

Complete identity verification schema supporting passport, drivers license, and national ID document types with liveness check metadata. Designed for financial institutions requiring compliant KYC workflows under EU AMLD6 and US BSA regulations.

kycidentityverificationamld6bsa

Schema Fields 12 fields

subject_id UUID required
Unique identifier for the verification subject
document_type Enum required
"passport" | "drivers_license" | "national_id"
document_number String required
Document number (sanitized, alphanumeric)
issuing_country ISO 3166-1 required
Two-letter country code of issuing authority
date_of_birth Date required
Subject date of birth (YYYY-MM-DD)
expiry_date Date required
Document expiration date
full_name String required
Full legal name as printed on document
liveness_score Float optional
Biometric liveness confidence (0.0–1.0)
liveness_hash String optional
SHA-256 hash of biometric capture
mrz_data Object optional
Machine readable zone parsed fields (passport only)
verification_timestamp DateTime required
ISO 8601 timestamp of verification event
metadata Object optional
Free-form metadata for implementation-specific fields

Example Payload

JSON 
{
  "subject_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "document_type": "passport",
  "document_number": "AB1234567",
  "issuing_country": "DE",
  "date_of_birth": "1990-05-14",
  "expiry_date": "2030-05-14",
  "full_name": "Maria Schmidt",
  "liveness_score": 0.97,
  "liveness_hash": "sha256:e3b0c44298fc1c149afbf4c...",
  "verification_timestamp": "2026-03-26T14:30:00Z"
}

Version History 5

v2.4.1 latest Mar 26, 2026

Fix optional field handling for national ID documents

v2.4.0 Mar 18, 2026

Add liveness check metadata fields and biometric hash support

v2.3.2 Feb 28, 2026

Improve date-of-birth validation for edge cases

v2.3.1 Feb 10, 2026

Security patch: sanitize document number inputs

v2.3.0 Jan 22, 2026

Add support for EU digital identity wallet credentials

Activity

Validations per day — last 28 days
28d ago21d14d7dtoday

API Usage

POST your payload to validate against the latest version.

cURL 
curl -X POST https://api.proseid.com/v1/validate/fincheck/kyc-identity-verification \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d @payload.json
200 OK
{
  "valid": true,
  "schema": "@fincheck/kyc-identity-verification",
  "version": "v2.4.1",
  "validated_at": "2026-03-26T14:30:01Z",
  "hash": "sha256:7f83b1657ff1fc53b92dc..."
}
422 Validation Failed
{
  "valid": false,
  "errors": [{
    "field": "document_type",
    "message": "Expected: passport, drivers_license, national_id",
    "received": "id_card"
  }]
}