REF · fin-glb-001 · @fincheck · EU / US · v2.4.1

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.

#kyc#identity#verification#amld6#bsa
Publication
Published
January 12, 2025
Updated
March 26, 2026
License
Apache-2.0
Dependents
24

Schema fields

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

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 releases
  1. v2.4.1 latest

    Fix optional field handling for national ID documents

    Mar 26, 2026
  2. v2.4.0

    Add liveness check metadata fields and biometric hash support

    Mar 18, 2026
  3. v2.3.2

    Improve date-of-birth validation for edge cases

    Feb 28, 2026
  4. v2.3.1

    Security patch: sanitize document number inputs

    Feb 10, 2026
  5. v2.3.0

    Add support for EU digital identity wallet credentials

    Jan 22, 2026

Activity

28 days
Validations per day
12,431 this week
28d ago21d14d7dtoday

API usage

POST your payload to validate against the latest version. Returns 200 if valid, 422 with structured field-level errors otherwise.

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 INVALID
{
  "valid": false,
  "errors": [{
    "field": "document_type",
    "message": "Expected: passport, drivers_license, national_id",
    "received": "id_card"
  }]
}