Error handling for Documents API and Identity API

This is a list of error codes that we recommend to manage. When responding to these errors, an error message should be sent to the user according to the error code to improve the user experience in case of failure.

Please note that the messages in the API response field "message" are for logs only and should not be used anywhere in the output.

These error codes are relevant for both identification and document signing.

Mobile ID error codes

1. Error code 6001 

{ 
"status": "error", 
"message": "User does not have a mobile signature.", 
"error_code": 6001 
}

2. Error code 6005 

{ 
"status": "error", 
"message": "Signing session expired.", 
"error_code": 6005 
}

3. Error code 7023 

{ 
"status": "error", 
"message": "Signing canceled by user.", 
"error_code": 7023 
}

Smart-ID error codes 

4. Error code 6005 

{ 
"status": "error", 
"message": "Signing session expired.", 
"error_code": 6005 
}

5. Error code 6006 

{ 
"status": "error", 
"message": "User does not have Smart-ID account.", 
"error_code": 6006 
}

6. Error code 6007 (occurs when user has Smart-ID Basic profile and is not allowed to sign documents with it):  

{ 
"status": "error", 
"message": "User can not use Smart-ID account.", 
"error_code": 6007 
}

7. Error code 6008 

{ 
"status": "error", 
"message": "User should view Smart-ID app or self-service portal", 
"error_code": 6008 
}

8. Error code 7023 

{ 
"status": "error", 
"message": "Signing canceled by user.", 
"error_code": 7023 
}


In all other cases, it is enough to display a message that there was an error and suggest to try again. And if the error persists - contact your support.

Should you need the complete list of Dokobit API error list, you can find it here.

Still need help? Contact us Contact us