Messari uses conventional HTTP response codes to indicate the success or failure of an API request. In general:
  • Codes in the 2xx range indicate success
  • Codes in the 4xx range indicate an error that failed given the information provided (e.g., a required parameter was omitted, an entity was not found, etc.)
  • Codes in the 5xx range indicate an error with Messari’s servers (these are rare)

​
HTTP Status Codes

HTTP Status CodeStatus TextDescription
200OKEverything worked as expected.
400Bad RequestThe request was unacceptable, often due to missing a required parameter.
401UnauthorizedNo valid API key provided.
402Request FailedThe parameters were valid but the request failed.
403ForbiddenThe API key doesn’t have permissions to perform the request.
404Not FoundThe requested resource doesn’t exist.
429Too Many RequestsToo many requests hit the API too quickly and were rate limited. We recommend an exponential backoff of your requests.
500Internal Server ErrorSomething went wrong on Messari’s end. (These are rare.)

​
Common Issues

​
Permissions Issues (403)

If you are receiving unexpected 403 errors for a service you believe you have access to, it is best to reach out to our customer support team. They should be able to help resolve your issue quickly.

​
Server Errors (500)

If you are receiving unexpected 500 errors then you might have found an issue with our system. Although we monitor for these, we appreciate reporting such errors so we can look into it and resolve the issue for you and others! Note: to expedite the resolution process, provide the request identifier when you contact us about a specific request.