API Reference

What do the response codes mean?

Our API uses conventional HTTP response codes to indicate success or failure of an API request. In general, codes in the 2xx range indicate success, codes in the 4xx range indicate an error from information provided as part of the request (e.g. the requested object doesn't exist, an invalid setting, etc.), and codes in the 5xx range indicate an error on our end.

The response of all API errors contain a message parameter which has developer-facing information about why the request failed.

See the table below for a list of error codes and their corresponding descriptions:

CodeSummaryDescription
200OKThe request completed successfully
400Bad RequestRequest is missing or has a bad parameter.
400Bad RequestRequest is missing or has an invalid API key.
401Not AuthorizedKey is valid, but account does not have permissions to perform this action.
403ForbiddenRequest is missing or has an invalid API key.
404Not FoundThe requested resource doesn't exist.

What about rate limits?

All of these endpoints are rate limited. You should be sure to check the response codes and retry requests that exceed the rate limit at a later time. If you hit rate limits, we recommend adjusting your request-rate using an exponential backoff.