Errors
Understand the error responses you may encounter when using the Guavy API, including authentication failures, rate limit violations, and standard HTTP status codes. Learn how to handle these errors gracefully in your application.
Authentication Errors
Authentication errors occur when you make a request without a valid Bearer token or API key in the Authorization header. When authentication fails, the API returns a JSON response with
"error": true
and an HTTP 401 Unauthorized status code.
HTTP Response Codes
The Guavy API uses standard HTTP response codes to indicate the success or failure of an API request. Here are some common response codes you may encounter:
-
401Unauthorized - Missing or invalid Bearer token in the Authorization header -
404Not Found - The requested endpoint or resource does not exist -
422Unprocessable Entity - The request was well-formed but contains invalid data or parameters -
429Too Many Requests - Rate limit exceeded, retry after the time specified in the response headers
API Limits
The Guavy API has a limit of 10 simultaneous connections. You'll receive a 429 error if you reach the limit. At exceptionally high volumes, you may receive an HTTP 429 or 403 without a JSON body.
We recommend that you cache frequently accessed values that do not change often in your application's data store. This will prevent your application from bumping up against the throttling limitations and will likely provide faster access to that data.
Account Limits
Your Guavy account will typically have a licensed limit of at least 100,000 API calls per month. In addition, there is a limit of 10,000 API calls per day. If you reach these limits, you will receive a 429 error.
Connection Timeouts
The Guavy API has a 120-second timeout on API calls. You may see this type of timeout after you've made a network socket connection and are already sending and receiving data. Response times are dependent on the complexity of your request and the general load across Guavy. Some endpoints in the Guavy API return values that are large and slow to calculate.
