Sometimes calls to the API endpoints may return errors due to external or internal reasons. Most errors include a 3 digit error code with additional detail in a JSON format and are listed in the table below.
| ERROR CODE | DESCRIPTION | Explanation |
|---|---|---|
| Authorization | ||
| 401 | Missing Authorization | API key required in Authorization header. Generate one in your BlockSpan portal. |
| 401 | Incorrect Credentials | The API key is incorrect. Obtain the correct key in your BlockSpan portal. |
| Account Quotas | ||
| 429 | Too Many Requests | Exceeded plan request per minute limits, resubmit at slower rate. See details on the pricing page [Link to Pricing Page]. |
| 429 | Max Transactions Exceeded | Exceeded plan monthly transaction limit. See details in your BlockSpan portal. Consider upgrading your plan or contact BlockSpan support. |
| Client Errors | ||
| 400 | Invalid Value | You provided an invalid value. See error message for details and API documentation for expected value. |
| 404 | Not Found | The requested resource was not found. Make sure your request url and parameters are correct. |
| Server Errors | ||
| 500 | Internal Server Error | An unexpected error occurred when processing your request. Please reach out to BlockSpan support. |
| 503 | Request Canceled | Due to high load, please try again shortly or reach out to BlockSpan support. |
| 503 | Service Down For Maintenance | The server is currently down for maintenance. |