Maplerad attempts to handle all mistakes and errors as gracefully as possible.

We use industry standard HTTP codes to group errors and also use conventional HTTP response codes to indicate the success or failure of an API request.


2XX Status code

Codes in this range confirms your request worked as expected (no errors)


4XX Status Code

Codes in this range indicates that the request failed due to the information in the request or situational reasons (e.g. an insufficient balance or a validation error on the request).


5XX Status Code

Codes in this range are extremely rare and indicates an error occurred on our system.

Status CodeMeaning
200, 201, 202Everything works as expected. API request was successful
400Bad request. Review the data sent in the request. Usually, this means a required piece of information is missing
401Unauthorized. This happens when you provide an invalid or non-existent API key
404Resource not found.
429You are sending way too many API requests and have been rate-limited
5XXSomething went wrong on our end. You should assume that we are being paged for all errors in this range