Innov8tif EMAS EKYC APIs
  • EMAS eKYC API
  • Innov8tif EMAS eKYC APIs Process Flow
  • OkayID
    • OkayID - Overall
    • OCR
      • Change Log
      • Version 3
      • Version 2
      • Version 1
    • Get Document Type
    • Document Type
      • Brunei
      • Cambodia
      • Indonesia
      • Malaysia
      • Myanmar
      • Philippines
      • Singapore
      • Thailand
      • United Arab Emirates
      • Vietnam
    • Field Type Reference
      • FieldType List
      • Brunei
      • Cambodia
      • Indonesia
      • Malaysia
      • Myanmar
      • Philippines
      • Singapore
      • Thailand
      • United Arab Emirates
      • Vietnam
      • Passport
    • Error List
    • Image Requirements
  • OkayID Lite
    • Indonesia
      • Version 1
    • Malaysia
      • Version 1
    • Thailand
      • Version 1
    • OCR(Non-Roman Character)
      • Version 1
    • Image Requirements
  • OKAYID LITE - MOBILE SDK
    • Getting Started with OkayID Lite
    • Installation Guide
    • Development
    • Changelog
  • OkayLive++
    • Anti-spoofing
  • OkayLive
    • Anti-spoofing
      • Change Log
      • Version 1
  • OkayFace
    • OkayFace - Overall
    • Face Verification
      • Version 1
    • 1:1 Face Verification V2
      • Change Log
    • 1:1 Face Verification V3
      • Change Log
    • 1:1 Face Verification V4
      • Change Log
    • 1:1 Face Verification V2-1
      • Change Log
    • 1:1 Face Verification V2-2
      • Change Log
    • 1:1 Face Verification V3-1
      • Change Log
    • 1:1 Face Verification V4-1
      • Change Log
    • Image Requirements
    • Error List
    • Face Search [BETA TESTING]
      • Face Insert
      • Face Query
      • Change Log
  • Face Detector - Mobile SDK
  • Getting Started with Face Detector
  • Installation Guide
  • Development
  • Changelog
    • Android
    • iOS
    • React-Native
  • OkayDoc
    • OkayDoc - Overall
    • Brunei
      • BN - Domestic ID Card
        • Change Log
        • Version 1
        • Recommended Threshold And Sample for Landmarks
      • BN - Permanent ID Card
        • Change Log
        • Version 1
        • Recommended Threshold And Sample for Landmarks
    • Cambodia
      • KH - ID Card Front
        • Change Log
        • Version 2
        • Version 1
        • Recommended Threshold And Sample for Landmarks
      • KH - ID Card Back
        • Change Log
        • Version 2
        • Version 1
        • Recommended Threshold And Sample for Landmarks
    • Indonesia
      • IDN - e-KTP Front
        • Change Log
        • Version 2
        • Version 1
        • Recommended Threshold And Sample for Landmarks
      • IDN - e-KTP Back
        • Change Log
        • Version 2
        • Version 1
        • Recommended Threshold And Sample for Landmarks
    • Malaysia
      • MYS - MyKad Front
        • Change Log
        • Version 7
        • Version 6
        • Version 5.1(Deprecated)
        • Version 5(Deprecated)
        • Version 3(Deprecated)
        • Recommended Threshold And Sample for Landmarks
        • holoFace and idFace Samples
      • MYS - MyKad Back
        • Change Log
        • Version 1
        • Recommended Threshold And Sample for Landmarks
      • MYS - MyKas
        • Change Log
        • Version 2
        • Version 1
        • Recommended Threshold And Sample for Landmarks
      • MYS - MyPR
        • Change Log
        • Version 2
        • Version 1
        • Recommended Threshold And Sample for Landmarks
      • MYS - MyTentera
        • Change Log
        • Version 2
        • Version 1
        • Recommended Threshold And Sample for Landmarks
      • MYS - Driving License
        • Change Log
        • Version 1
        • Recommended Threshold And Sample for Landmarks
      • MYS - MyOKU(beta)
        • Change Log
        • Version 1
        • Recommended Threshold And Sample for Landmarks
    • Myanmar
      • MM - Driving License
        • Change Log
        • Version 1
        • Recommended Threshold And Sample for Landmarks
    • Philippines
      • PH - Driving License
        • Change Log
        • Version 2
        • Version 1
        • Recommended Threshold And Sample for Landmarks
      • PH - SSS
        • Change Log
        • Version 2
        • Version 1
        • Recommended Threshold And Sample for Landmarks
      • PH - PRC Professional ID Card
        • Change Log
        • Version 2
        • Version 1
        • Recommended Threshold And Sample for Landmarks
      • PH - UMID
        • Change Log
        • Version 2
        • Version 1
        • Recommended Threshold And Sample for Landmarks
      • PH - Voter ID
        • Change Log
        • Version 1
        • Recommended Threshold And Sample for Landmarks
      • PH - Postal ID
        • Change Log
        • Version 1
        • Recommended Threshold And Sample for Landmarks
    • Singapore
      • SG - NRIC Front
        • Change Log
        • Version 2-1
        • Version 2
        • Version 1
        • Recommended Threshold And Sample for Landmarks
      • SG - NRIC Back
        • Change Log
        • Version 1
        • Recommended Threshold And Sample for Landmarks
    • Thailand
      • TH - ID Card
        • Change Log
        • Version 2
        • Version 1
        • Recommended Threshold And Sample for Landmarks
    • United Arab Emirates
      • UAE - ID Card
        • Change Log
        • Version 1
        • Recommended Threshold And Sample for Landmarks
    • Vietnam
      • VN - Old ID Card
        • Change Log
        • Version 2
        • Version 1
        • Recommended Threshold And Sample for Landmarks
      • VN - New ID Card
        • Change Log
        • Version 2
        • Version 1
        • Recommended Threshold And Sample for Landmarks
    • Non Passport
      • Change Log
      • Version 1
    • Passport
      • Change Log
      • Version 3
      • Version 2
      • Version 1
      • Recommended Threshold for Landmarks
      • Landmarks checked for Passport
      • Half-sized and Full-sized Passport Image Samples
    • Data Consistency Check
      • Version 1
      • Passport MRZ-Visual Consistency Check and MRZ Validity
    • Error List
    • Supported Documents and Check Type
    • Image Requirements
  • OkayDoc - Mobile SDK
    • Getting Started with OkayDoc
    • Installation Guide
    • Development
    • Changelog
  • OkayCam - Mobile SDK
    • Getting Started with OkayCam
    • Installation Guide
    • Development (Document Capture)
    • Development (Face Capture)
    • Error/Exception Handling
    • Changelog
      • Android
      • iOS
      • React-Native
  • OkayDB
    • OkayDB -Overall
    • AML
      • Search Business
        • Version 1
      • Search By BusinessID
        • Version 1
      • Search Person
        • Version 1
      • Search By Person ID
        • Version 1
      • Save Result as PDF
        • Version 1
      • Postman Collection
    • Indonesia
      • e-KTP Check
        • Version 1
    • Malaysia
      • Information Check
        • Version 3
        • Version 2
        • Version 1
    • Vietnam
      • Driver License Check
        • Version 1
  • Other
    • OkayID Web Camera
      • HTML Media Capture - Upload Approach
      • Web RTC - High Resolution
      • Web RTC - Screen Capture
      • Operating System Detection
    • OkayLive Web Camera
    • IDV App URL
    • ID Collection Application
    • FAQ
  • Other API
    • Get Details by ID
    • Fake ID Detection
  • EMAS eKYC Portal
    • Create JourneyID
    • Centralized OkayID
    • Centralized OkayFace
    • Centralized OkayFace(v1-1)
    • Centralized OkayLive
    • Centralized OkayDoc
      • Non-passport
      • Passport
    • Get Scorecard Result
    • Get Scorecard Config
    • Postman Collection
    • Error List
Powered by GitBook
On this page

Was this helpful?

  1. OkayFace

Error List

Missing apiKey
{"error":"MISSING_ARGUMENT: apiKey","request_id":null}
Wrong apiKey
{"error":"INVALID_API_KEY","request_id":null}
API key expired
{
    "status": "error",
    "message": "API_KEY_EXPIRED",
    "result": null
}
Maximum API call hit
{
    "status": "error",
    "message": "MAX_API_CALL_EXCEEDED",
    "result": null
}
Missing imageIdCard/imageBest
{"error":"MISSING_ARGUMENTS: imageIdCard or imageBest","request_id":null}
imageIdCard/imageBest's file size more than 3MB
{"error":"PAYLOAD_TOO_LARGE"}
Invalid imageIdCard/imageBest Format(Support:jpg、jpeg、png)
{"error":"Photo format error","request_id":null}
Invalid imageIdCard/imageBest has no face detected
{"error":"FACE_NOT_FOUND","request_id":"xxxxxxxxxx"}

Error messages

Error

Description

FACE_TOO_CLOSE

A distance between face and camera is too small for preprocessing issues

FACE_CLOSE_TO_BORDER

Face is too close to one or more borders. May reduce the accuracy of spoofing detection because edges of face may not be seen

FACE_CROPPED

Face is cropped. May reduce the accuracy of spoofing detection because edges of face may not be seen

FACE_IS_OCCLUDED

There is occlusion on the face or it is difficult to see face, which degrades the quality of liveness

FACE_NOT_FOUND

Face detector can't find face on image

TOO_MANY_FACES

Face detector found more than one face on image

FACE_TOO_SMALL

Facial area is not big enough for analysis. Either interpupillary distance(80px) or face size(224 px) is below the configured value.

FACE_ANGLE_TOO_LARGE

Facial out-of-plane rotation angle is extremely large

FAILED_TO_PREDICT_LANDMARKS

Landmarks prediction error

UNKNOWN

Unhandled exception in the code

PreviousImage RequirementsNextFace Search [BETA TESTING]

Last updated 3 years ago

Was this helpful?