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.