Document Verification

Walkthrough Video

Overview

The document verification process analyzes identity documents such as passports, driver’s licenses, and national ID cards to:

Extract personal information using advanced OCR technology
Verify document authenticity through security feature detection
Detect tampering or forgery using machine learning algorithms
Validate document integrity and format compliance

Supported Document Types

Urtentic supports identity documents from 195+ countries and territories:

Passports

All standard ICAO-compliant passports

National ID Cards

Government-issued identity cards

Driver's Licenses

Domestic driving licenses

Residence Permits

Permanent and temporary residence documents

Configuration Options

Security Settings

Gallery Restriction: Prevent users from uploading photos from gallery
Screenshot Restriction: Block screenshots of documents
Age Restriction: Set minimum age requirement (18-100)
Duplicate Detection: Choose action for duplicate verifications (REJECTED / REVIEW_NEEDED)

Quality Settings

Face Match Threshold: Minimum confidence for document photo vs selfie matching
Document Types: Configure which document types to accept

{
  "settings": [
    { "fieldName": "GALLERY_RESTRICTION", "value": true },
    { "fieldName": "RESTRICT_SCREENSHOT", "value": true },
    { "fieldName": "RESTRICT_AGE", "value": 18 },
    { "fieldName": "DUPLICATE_DETECTION", "value": "REJECTED" },
    { "fieldName": "FACEMATCH_THRESHOLD", "value": 0.85 },
    { "fieldName": "DOCUMENT_TYPES", "value": ["PASSPORT", "DRIVERS_LICENSE", "NATIONAL_ID"] }
  ]
}

Data Extraction

The system extracts structured data from documents:

Output	Description
Full Name	Extracted from document
Date of Birth	Parsed date
Age Check	Boolean age validation
Document Number	Unique document ID
Document Type	PASSPORT, DRIVERS_LICENSE, etc.
Issue/Expiry Dates	Document validity period
Address	Extracted address
Country of Issuance	Issuing country
Nationality	Holder nationality
Template Matching	Authenticity check result
Alteration Detection	Tampering detection result

API Integration

Step 1: Submit Document for Verification

Endpoint: POST /api/v1/verifications/{verificationId}/send-inputs

curl -X POST https://api.urtentic.com/api/v1/verifications/{verificationId}/send-inputs \
  -H "Authorization: Bearer ${API_KEY}" \
  -H "X-CLIENT-ID: ${CLIENT_ID}" \
  -F 'inputs=[{"fieldName":"DOCUMENT_PHOTO","fileName":"passport.jpg","type":"FILE"}]' \
  -F 'documents=@/path/to/passport.jpg'

Response:

{
  "status": "success",
  "message": "Inputs received successfully",
  "verificationId": "85c94e71-6e3f-4a19-b15c-781d8a876542"
}

Step 2: Get Verification Results

Endpoint: GET /api/v1/verifications/{verificationId}

curl -X GET https://api.urtentic.com/api/v1/verifications/85c94e71-6e3f-4a19-b15c-781d8a876542 \
  -H "Authorization: Bearer ${API_KEY}" \
  -H "X-CLIENT-ID: ${CLIENT_ID}"

Response:

{
  "id": "85c94e71-6e3f-4a19-b15c-781d8a876542",
  "flowId": "db50ed08-18fa-41e8-9e46-a44aca39f69d",
  "status": "COMPLETED",
  "documentEntities": [
    {
      "type": "PASSPORT",
      "country": "USA",
      "fields": {
        "full_name": { "label": "Full Name", "value": "John Smith" },
        "date_of_birth": { "label": "Date of Birth", "value": "1990-05-15" },
        "document_number": { "label": "Document Number", "value": "123456789" },
        "expiry_date": { "label": "Expiry Date", "value": "2030-03-10" },
        "nationality": { "label": "Nationality", "value": "United States" }
      }
    }
  ]
}

Webhook Notification

{
  "eventName": "step_completed",
  "flowId": "db50ed08-18fa-41e8-9e46-a44aca39f69d",
  "timeStamp": "2024-01-10T10:31:00.000Z",
  "resource": "/api/v1/verifications/85c94e71-6e3f-4a19-b15c-781d8a876542",
  "metadata": { "userId": "user_12345" },
  "id": "DOCUMENT_VERIFICATION",
  "status": 1,
  "data": {
    "full_name": "John Smith",
    "date_of_birth": "1990-05-15",
    "age_check": true,
    "document_number": "123456789",
    "document_type": "PASSPORT",
    "date_of_issue": "2020-03-10",
    "expiry_date": "2030-03-10",
    "country_of_issuance": "USA",
    "nationality": "United States",
    "sex": "M",
    "template_matching_result": "PASSED",
    "alteration_detection_results": "NO_ALTERATIONS_DETECTED"
  }
}

Process Dependencies

Document verification can use data from other processes:

Liveness: Optional face matching with selfie photo
Video Agreement: Optional face matching with video frame

Implementation Tips

User Experience

Show real-time feedback during document capture
Allow photo retakes for quality issues
Provide clear instructions for document positioning
Explain why document verification is needed

Technical Implementation

Compress images before upload (max 10MB recommended)
Validate file formats (JPEG, PNG) client-side
Handle network timeouts gracefully
Implement progressive upload for large files

Security & Compliance

Always use HTTPS for document uploads
Log verification attempts for audit purposes
Set appropriate data retention periods
Restrict access to extracted document data

Getting Started

Verification Processes

Webhooks

SDK

Walkthrough Video

Overview

Supported Document Types

Passports

National ID Cards

Driver's Licenses

Residence Permits

Configuration Options

Data Extraction

API Integration

Step 1: Submit Document for Verification

Step 2: Get Verification Results

Webhook Notification

Process Dependencies

Implementation Tips

​Walkthrough Video

​Overview

​Supported Document Types

Passports

National ID Cards

Driver's Licenses

Residence Permits

​Configuration Options

​Data Extraction

​API Integration

​Step 1: Submit Document for Verification

​Step 2: Get Verification Results

​Webhook Notification

​Process Dependencies

​Implementation Tips

Walkthrough Video

Overview

Supported Document Types

Configuration Options

Data Extraction

API Integration

Step 1: Submit Document for Verification

Step 2: Get Verification Results

Webhook Notification

Process Dependencies

Implementation Tips