# Error Lists

{% hint style="info" %}
OK response data is always in JSON format. If received code 200, the data has been accepted, however, there can be one of the following error messages:
{% endhint %}

## OkayLive Error Lists

| Message                        | Description                                                       |
| ------------------------------ | ----------------------------------------------------------------- |
| Failed to decode image         | Image format is not supported.                                    |
| Can't read image from bytes    | File is corrupted.                                                |
| Failed while detecting face    | Face detection module failed during processing of image.          |
| Failed to detect face          | Face detector can't find faces.                                   |
| Failed while predict landmarks | Facial landmarks cannot be found.                                 |
| Failed to convert image        | Internal error. Please send raw data to developers for debugging. |
| Failed to predict result       | Internal error. Please send raw data to developers for debugging. |
| Failed to crop face            | Face is too close to camera.                                      |
| Face image is too small        | Face width or height is under 224 pixels.                         |

## OkayFace & OkayLive Error Lists

| Error Message                                         | Error Code                                   | Descriptions                                                                                                                                                          |
| ----------------------------------------------------- | -------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Absolute face size is too small                       | FACE\_TOO\_SMALL                             | Face is too far away from the camera. Please make sure that your face is closer to the camera.                                                                        |
| Face is cropped                                       | FACE\_CROPPED                                | Face is partially missing from the frame. Please make sure your face fit into the camera frame or in the center.                                                      |
| Face is occluded                                      | FACE\_IS\_OCCLUDED                           | Face is partially blocked by object. Please make sure that your face is free of masks or any other object.                                                            |
| Face is too close to one or more borders              | FACE\_CLOSE\_TO\_BORDER                      | Face is too close or shifted away from the center of the camera. Please make sure that your face is further away and at the center of the camera.                     |
| Face is too close to the camera                       | FACE\_TOO\_CLOSE                             | Face is too close to the camera. Please make sure to move your face further away from the camera.                                                                     |
| Facial out-of-plane rotation angle is extremely large | FACE\_ANGLE\_TOO\_LARGE                      | Face is not facing towards the camera. Please adjust your face straight facing the camera.                                                                            |
| Failed to detect face                                 | FACE\_NOT\_FOUND                             | Face is not detected. Please make sure your face is present in the camera frame.                                                                                      |
| Interpupillary distance is too small                  | FACE\_TOO\_SMALL                             | Facial area is not big enough for analysis. The distance of the face too far that cause the eye distances too close to each others. Please move closer to the camera. |
| Relative face size is too small                       | FACE\_TOO\_SMALL                             | Face is too small to be detected. The face size is below the minimum requirement, please make sure the your face is closer to the camera.                             |
| Too many faces detected                               | TOO\_MANY\_FACES                             | More than 1 face present in the camera. Please make sure that there is no more than one face present in the camera.                                                   |
| -                                                     | PAYLOAD\_TOO\_LARGE                          | The image being sent is too large, please make sure that the image is within the requirement image size                                                               |
| MISSING\_ARGUMENTS: imageIdCard or imageBest          | MISSING\_ARGUMENTS: imageIdCard or imageBest | The image parameter is missing. Please make sure the image is submitted when API is called.                                                                           |
| Data field is compulsory.                             | -                                            | Please check your parameter again before calling the API.                                                                                                             |

## Sample Response

{% code title="File Size too big" %}

```
{
    "status": "error",
    "message": "PAYLOAD_TOO_LARGE"
}
```

{% endcode %}

{% code title="Face is occluded" %}

```
{
    "status": "error",
    "message": "FACE_IS_OCCLUDED"
}
```

{% endcode %}

{% code title="Missing data field " %}

```
{
    "status": "error",
    "message": "Data field is compulsory."
}
```

{% endcode %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://api2-ekycapis.innov8tif.com/okaylive/okaylive-all/error-lists.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.