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 Code | Status Text | State Description |
|---|---|---|
| 200 | OK | Everything worked as expected. |
| 400 | Bad Request | The request was unacceptable, often due to missing a required parameter. |
| 401 | Unauthorized | No valid API key provided. |
| 402 | Request Failed | The parameters were valid but the request failed. |
| 403 | Forbidden | The API key doesn’t have permissions to perform the request. |
| 404 | Not Found | The requested resource doesn’t exist. |
| 429 | Too Many Requests | Too many requests hit the API too quickly and were rate limited. We recommend an exponential backoff of your requests. |
| 500 | Internal Server Error | Something went wrong on Messari's end. (These are rare.) |
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.
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.