Error Status Codes

Error messages from our APIs are mostly in the format
{
    "status": "error",
    "code": "<error_string>",
    "message": "<error_message>"
}
​
Below are the possible HTTP error status codes that can occur for an API request.
HTTP Error Code
Meaning
401
This means your request is not authenticated. To fix this see the Authentication section
400
This means your request for the particular service is missing some parameters( or fields). To fix this, kindly ensure your request matches the documentation for that service.
404
This means the entity you are requesting ( ie Identity, submitted address, submitted guarantor request) cannot be found or does not exist.
422
This means your request could not be processed. This error is returned mainly when your wallet balance is insufficient for the request you made. To fix this, Kindly fund your wallet.
503
This means the service you are  requesting is not available at the time of the request

Product statuses

Glossary

Last modified 1yr ago

HTTP Error Code	Meaning
401	This means your request is not authenticated. To fix this see the Authentication section
400	This means your request for the particular service is missing some parameters( or fields). To fix this, kindly ensure your request matches the documentation for that service.
404	This means the entity you are requesting ( ie Identity, submitted address, submitted guarantor request) cannot be found or does not exist.
422	This means your request could not be processed. This error is returned mainly when your wallet balance is insufficient for the request you made. To fix this, Kindly fund your wallet.
503	This means the service you are requesting is not available at the time of the request