Liveliness Error Responses

Types and causes of error responses when uploading face motion video to the Lapis eKYC API

• If the provided API key is invalid, the following error message will be returned. Please ensure that the API key you provide is correct and valid.

Response status: 401

{
    "error": "invalid api key"
}

• If an invalid video URL is provided, the following error message will be returned. Please ensure that the video URL you provide is correct and accessible.

Response status: 400

{
    "error": "invalid face video provided"
}

• If an invalid video base64 is provided, the following error message will be returned. Please ensure that the video base64 is type of png or jpeg.

Response status: 400

{
    "error": "invalid base64 video provided"
}

• If two types of video provided for face video (URL and base64), the following error message will be returned.

Response status: 400

{
    "error": "only one face video is accepted!"
}

• If size of base64 video exceeds 30mb, the following error message will be returned.

Response status: 413

Request Entity Too Large

• If no document verification session is found with the provided ID, the following error message will be returned indicating that no matching session was found for the given ID.

Response status: 400

{
    "error": "There is no document identification data with the provided id!"
}

• If the provided face video failed the test, the following error message will be returned.

Response status: 400

{
    "error": ":liveliness verification FAILED!"
}