Status codes and errors#
LUNA ID responds with status codes and error messages to let you know how things are going.
LUNA ID for Android#
LUNA ID initialization exceptions#
| Exception | Description |
|---|---|
TRACK_ENGINE_CONFIG_CREATION_FAILED |
Failed to create the TrackEngine configuration file. |
TRACK_ENGINE_CREATION_FAILED |
Failed to create TrackEngine. |
BESTSHOT_QUALITY_ESTIMATOR_CREATION_FAILED |
Failed to create BestShotQualityEstimator. |
LIVENESS_ONE_SHOT_RGB_ESTIMATOR_CREATION_FAILED |
Failed to create LivenessOneShotRGBEstimator. |
MASK_ESTIMATOR_CREATION_FAILED |
Failed to create MedicalMaskEstimator. |
QUALITY_ESTIMATOR_CREATION_FAILED |
Failed to create QualityEstimator. |
GLASSES_ESTIMATOR_CREATION_FAILED |
Failed to create GlassesEstimator. |
BESTSHOT_OBSERVER_CREATION_FAILED |
Failed to create a best shot observer. |
FACE_ENGINE_CREATION_FAILED |
Failed to create FaceEngine. |
LICENSE_PROVIDER_CREATION_FAILED |
Failed to create a license provider. |
CACHE_PROVIDER_CREATION_FAILED |
Failed to create a cache provider. |
LICENSE_FETCH_FAILED |
Failed to fetch the LUNA ID license. |
LICENSE_ACTIVATION_FAILED |
Failed to activate the LUNA ID license. |
WARPER_CREATION_FAILED |
Failed to create a warper. |
FACE_DETECTOR_CREATION_FAILED |
Failed to create a face detector. |
EYE_ESTIMATOR_CREATION_FAILED |
Failed to create EyeEstimator. |
OneShotLiveness estimation status codes#
| Code | Status | Description |
|---|---|---|
| 200 | Success. | The OneShotLiveness estimation request has reached the server and the server was able to process it. |
| 400 | Bad request. | The server cannot process the OneShotLiveness estimation request due to a client error. |
| 403 | Forbidden. | The server understands the OneShotLiveness estimation request but refuses to authorize it due to an error on the client side. |
| 408 | Request payload too large. | The server is unable to process the OneShotLiveness estimation request due to an error on the server side. |
| 413 | Service did not process the request within the specified period. | The OneShotLiveness estimation request payload exceeds the maximum size limit defined by the server. |
| 500 | Internal server error. | The server encountered an unexpected condition that prevented it from fulfilling the OneShotLiveness estimation request. |
| 503 | Service did not process the request within the specified period. | The server is currently unable to handle the OneShotLiveness estimation request due to maintenance or an overload of requests. |
| 504 | Server timeout error. | The server did not receive a timely response from the upstream server that it needed to complete the OneShotLiveness estimation request. |
Best shot estimation errors#
| Error | Description |
|---|---|
BadEyesStatus |
Eyes in the frame are occluded or closed. For details, see Eye state estimation. |
BadHeadPose |
Head rotation angles are not in the specified range. For details, see Head pose. |
BadQuality |
Image quality is low. For details, see Image quality estimation. |
BlurredFace |
A face in the frame is blurred. For details, see Image quality estimation. |
FaceLost |
A face that has been tracked disappeared from the frame. |
FaceOutOfFrame |
A face is too close to the camera and does not fit the face recognition area. |
GlassesOn |
Eyes in the frame are occluded with glasses. For details, see Glasses estimation. |
OccludedFace |
A face in the frame is covered with a medical mask. For details, see Medical mask estimation. |
PrimaryFaceLost |
The primary face has disappeared from the frame and another face has appeared. |
TooDark |
The image is underexposed, that is, too dark. For details, see Image quality estimation. |
TooManyFaces |
The frame has more than one face. |
TooMuchLight |
The image is overexposed, that is, too light. For details, see Image quality estimation. |
LUNA ID for iOS#
The below status codes apply to LUNA ID for iOS.
| Code | Error message | Description |
|---|---|---|
| 1000 | LunaCore initialization error | Failed to initialize the LunaCore module. |
| 1001 | Low image quality. Check filming conditions | The input image does not meet the required image quality thresholds. |
| 1002 | Wrong head pose. Turn your head towards the camera and keep it straight | Head rotation angles are not between the minimal and maximum valid head position values. |
| 1003 | Multiple faces detected. A single face is expected. | More than one face was detected in the frame. Ensure only one face is visible to the camera. |
| 1004 | Liveness check failed | OneShotLiveness estimation failed. The system could not verify that a real person is present. This may indicate a spoofing attempt. |
| 1006 | Please blink to continue | The blink interaction for Dynamic Liveness estimation was not detected or performed incorrectly. |
| 1007 | Interaction timeout | The frame was not received in the time interval allotted for the best shot. |
| 1010 | Face is occluded. Make sure there are no foreign objects covering face | The face is not properly visible in the input image. Remove any objects blocking facial features. |
| 1011 | Bad filming conditions: face is blurred | The input image does not meet the blurriness threshold. |
| 1012 | Bad filming conditions: too dark | The input image does not meet the darkness threshold. |
| 1013 | Bad filming conditions: too much light | The input image does not meet the lightness threshold. |
| 1014 | Bad filming conditions: too dark, too much light, face is blurred | The input image does not meet the illumination threshold. |
| 1015 | Bad filming conditions: too dark, too much light, face is blurred | The input image does not meet the specularity threshold. |
| 1016 | Face is too far. Move face closer to the camera | The bounding box size with the detected face does not correspond to the specified size. Move closer to fill the recommended space. |
| 1017 | Face is out of frame or too close to the border. Move face to the center of the frame | The bounding box size with the detected face does not correspond to the specified size. Center your face in the frame. |
| 1018 | Rotate you head to the left | The head rotation to the left was not detected or was insufficient for Dynamic Liveness estimation. |
| 1019 | Rotate you head to the right | The head rotation to the right was not detected or was insufficient for Dynamic Liveness estimation. |
| 1020 | Move your head down | The downward head movement was not detected or was insufficient for Dynamic Liveness estimation. |
| 1021 | Move your head up | The upward head movement was not detected or was insufficient for Dynamic Liveness estimation. |
| 1023 | The face is lost. Please return the original face back to frame | The primary face that was detected in the video stream has been lost. |
| 1024 | Please take off your sunglasses | Sunglasses are obstructing eye visibility, which is required for estimation. |
| 1025 | License check failed | LUNA ID failed to check the license. To use LUNA ID, you must have a valid license. |
| 1027 | Face is lost. Please take a look at camera again | The primary face that was detected in the video stream has been lost. A video recording will be forcibly terminated. |
| 1028 | Face was not found | No face was detected within the allotted time interval. |
| 1029 | Mouth is occluded. Make sure there are no foreign objects covering face | The mouth area is covered, preventing proper facial analysis. |
| 1031 | Lower part of the face is occluded | The chin, mouth, or lower cheek area is obstructed by objects or clothing. The face occlusion estimation failed. |
| 1033 | Nose is occluded | The nose is covered. The face occlusion estimation failed. |
| 1034 | Eyes are occluded | Eyes are not visible. The face occlusion estimation failed. |
| 1035 | Forehead is occluded | The forehead area is covered. The face occlusion estimation failed. |