Skip to main content

​
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

  • 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)
  • 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:
OutputDescription
Full NameExtracted from document
Date of BirthParsed date
Age CheckBoolean age validation
Document NumberUnique document ID
Document TypePASSPORT, DRIVERS_LICENSE, etc.
Issue/Expiry DatesDocument validity period
AddressExtracted address
Country of IssuanceIssuing country
NationalityHolder nationality
Template MatchingAuthenticity check result
Alteration DetectionTampering 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

  • 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
  • Compress images before upload (max 10MB recommended)
  • Validate file formats (JPEG, PNG) client-side
  • Handle network timeouts gracefully
  • Implement progressive upload for large files
  • Always use HTTPS for document uploads
  • Log verification attempts for audit purposes
  • Set appropriate data retention periods
  • Restrict access to extracted document data