Status codes#
LUNA ID responds with status codes to let you know how things are going.
LUNA ID for Android#
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. |
LUNA ID for iOS#
LunaCore initialization errors#
The below status codes apply to LUNA ID for iOS.
| Code | Error message | Description |
|---|---|---|
| 1000 | LunaCore module initialization error. | The LunaCore module failed to initialize. |
| 1001 | Bad quality. | The input image does not meet image quality thresholds. |
| 1002 | The user’s head is turned too much. | Head rotation angles are not between the minimal and maximum valid head position values. |
| 1003 | Multiple faces were detected in the frame. | The frame must contain only one face for LUNA ID to perform a series of estimations, and then select the best shot. |
| 1004 | Liveness check has not been passed. | OneShotLiveness estimation failed. |
| 1005 | A face has not been found. | For the image to be considered the best shot, it must contain a face. |
| 1006 | Need to blink. | A Dynamic Liveness estimation interaction error. |
| 1007 | Interaction timeout. | The frame was not received in the time interval allotted for the best shot. |
| 1008 | Medical mask is on the face. | The person in the input image is currently wearing a medical mask on the face. |
| 1009 | Mask is not on the right place. | The mask is not covering the right areas on the person's face. |
| 1010 | Face is occluded by something. | The face is not properly visible in the input image. |
| 1011 | The image is blurred. | The input image does not meet the blurriness threshold. |
| 1012 | The image is underexposed (i.e., too dark). | The input image does not meet the darkness threshold. |
| 1013 | The image is overexposed (i.e., too light). | The input image does not meet the lightness threshold. |
| 1014 | The face in the image is illuminated unevenly (there is a great difference between light and dark regions). | The input image does not meet the illumination threshold. |
| 1015 | Image contains flares on face (too specular). | The input image does not meet the specularity threshold. |
| 1016 | The face is too far. | The bounding box size with the detected face does not correspond to the specified size. |
| 1017 | The face overlaps borders. | The bounding box size with the detected face does not correspond to the specified size. |