API error guide

Understand common api error codes and learn how to resolve technical issues in your requests.

401 Unauthorized

Your request is missing valid authentication credentials or permissions are invalid.

Solution

  1. Ensure the Authorization header contains a valid bearer token
  2. Check the token expiration date in your account settings
  3. Regenerate API keys if they appear compromised

400 Bad Request

The server cannot process your request due to malformed syntax or invalid parameters.

Solution

  1. Validate JSON payloads using JSON validation tools
  2. Check request headers for missing or incorrect Content-Type
  3. Verify API versions match expected endpoints

404 Not Found

The requested endpoint or resource cannot be found in our systems.

Solution

  1. Double-check endpoint spelling against official documentation
  2. Confirm correct API version in request headers
  3. Verify resource IDs actually exist in your user account

500 Internal Server Error

A server-side issue has occurred while processing your request.

Solution

  1. Wait 5-10 minutes and retry the request
  2. Check system status for ongoing incidents
  3. Contact support with full request/response details

429 Too Many Requests

You have exceeded rate limits for the current API plan.

Solution

  1. Add retry-after headers to retry after the specified delay
  2. Upgrade to a higher tier plan for increased rate limits
  3. Implement request batching to reduce request count

Current rate limit: 60 requests/min. Upgrade your plan for higher limits

413 Payload Too Large

The request body exceeds size limits for the current API endpoints.

Solution

  1. Compress request data before sending
  2. Split requests into smaller batches
  3. Contact support for increased limits on Pro accounts

Still need help?

If these solutions don't resolve your issue, our support team is available for personalized assistance.

Contact Support View Knowledge Base