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