Documentation
  • Introduction
  • ⚡Quick Guide
  • APIs
    • 🔑OAuth Token
    • 🆔National ID OCR
      • 🔁API Response
    • ✈️Passport
    • 🇦🇪UAE Resident ID OCR
    • 🧑‍💼Face Match
      • Face Match (Two Images)
      • Face Match (Image & Transaction ID)
    • ✈️Libyan passport
    • 🚗Egyptian Car License
    • 🇲🇦Moroccan Documents OCR
      • 🆔Moroccan National ID (MRZ & Barcode)
      • ✈️Moroccan Passport
      • 🗂️Moroccan Residency Card
      • 🚗Moroccan Driving License
    • ↔️Transliteration
      • National ID Transliteration
      • Commercial Register Translation
      • Names Transliteration
    • 🏫Know Your Business (eKYB)
      • 📖Data Extraction & Verifications
        • Egyptian Commercial Register ID OCR
          • ✅With Verification
        • Egyptian Tax Card OCR
    • 📄Valify Sanction Shield
      • Sanction Shield v2.1.0
    • Sanction Shield v2.0.0
    • 🛡️Supported lists
    • ❓Transaction Inquiry
    • 📷Fetch Images
    • 🔒OTP
      • 📲Send Phone OTP
      • ✅Verify Phone OTP
      • 📥Send Email OTP
      • ✅Verfiy Email OTP
    • Response Data Validation
  • Error Codes
    • Valify Error Codes
    • HTTP Codes
  • References
Powered by GitBook
On this page
  • Advanced confidence breakdown
  • Profession Analysis breakdown
  • Document Verification Plus breakdown
  1. APIs
  2. National ID OCR

API Response

API Response

  • Review Required: This additional list will be sent with the API response. It contains a list of fields that have caused either the front data validity or back data validity to be classified as false. These are the fields that may be required to go through manual review due to OCR-related issues.

{
    "result": 
    {
        "first_name": '<string>',
        "full_name": '<string>',
        "street": '<string>',
        "front_nid": '<string>',
        "serial_number": '<string>',
        "back_nid":'<string>',
        "release_date": '<string>',
        "gender": '<string>',
        "marital_status": '<string>'
        "profession": '<string>',
        "religion":'<string>',
        "husband_name": '<string>',
        "date_of_birth": '<string>',
        "age":'<int>',
        "birth_governarate": '<string>',
        "police_station": '<string'>,
        "governorate": '<string>',
        "expiry_date": '<string>',
    },
    
     "advanced_confidence": 
    {
        'fraud_detection_zone': <int>,
          'fraud_detection_details': {
          'face_fraud_zone': <int>, 
          'face_fraud_confidence': <float>, 
          'front_image_manipulation_zone': <int>,
          'front_image_manipulation_confidence': <float>
          }
    },
  
   "document_verification_plus": 
   {
        "expired": '<boolean>',
        "front_data_validity": '<boolean>',
        "back_data_validity": '<boolean>',
        "is_front_greyscale": '<boolean>',
        "is_back_greyscale": '<boolean>',
        "review_required": '<list>'
    },
    
   "profession_analysis": 
   {
        "workplace": '<string>',
        "profession_categorization": '<string>'
    },
    
    "transaction_id": '<string>',
    "trials_remaining": '<int>'
}

Advanced confidence breakdown

"fraud_detection_zone" acts as a parent for "face_fraud_zone" and "front_image_manipulation_zone". if either of them is yellow/red, the result is of this flag will be yellow/red.

  • "fraud_detection_zone": values "0" for green zone, "1" for yellow zone (needs review) and "2" for red zone. This value defines an overall fraud zone for the NID.

  • "face_fraud_zone": Same values as "fraud_detection_zone" but for face manipulation specifically.

  • "'face_fraud_confidence": float values from 0 to 1 indicating to what degree the face might be manipulated.

  • "front_image_manipulation_zone": Same values as "fraud_detection_zone" but generic for any manipulation in the NID.

  • "'front_image_confidence": float values from 0 to 1 indicating to what degree the NID might be manipulated.

Profession Analysis breakdown

This section breaks down the profession field as follows

  • "workplace": This is the extraction of the workplace from the profession field. If the workplace does not exist, then this field is returned as empty

  • "profession_categorization": The returns the category that this specific occupation pertains to. Please check the list below

    • Salaried

    • Unemployed

    • Self-employed

    • Student

    • Retired

    • Housewife

    • Freelancer

    • Public Official

Document Verification Plus breakdown

The following are possible values that could come in the review required list along with their triggers

  1. date_of_birth triggered by an invalid date or incorrect format

  2. street when the field value is missing from the response

  3. police_station when the field value is missing from the response

  4. governorate when the field value is missing from the response

  5. birth_governorate triggered by an invalid field format

  6. back_nid triggered by an invalid field format

  7. front_nid triggered by an invalid field format

  8. serial_number triggered by an invalid field format

  9. full_name triggered when the field value is missing from the response

  10. first_name triggered when the field value is missing from the response

  11. expiry_date triggered by an invalid date or incorrect format

  12. release_date triggered by an invalid date or incorrect format

  13. front_img triggered when is_front_greyscale is true

  14. back_img triggered when is_back_greyscale is true

PreviousNational ID OCRNextPassport

Last updated 6 months ago

🆔
🔁