Knowledge HubTroubleshootingAPI Integration Errors
Troubleshootingapierrorsdebugging

API Integration Errors

Debug common API errors — 401, 403, 429, 500 and how to fix them

3 min min readFor: developers

API Integration Errors

401 Unauthorized

  • Verify your API key is correct and active
  • Check the Authorization header format: Bearer YOUR_API_KEY
  • Ensure the key has not been revoked
  • 403 Forbidden

  • Your plan may not include API access (Growth+ required)
  • The endpoint may require a specific role (e.g., admin-only endpoints)
  • 429 Rate Limited

  • You have exceeded your rate limit (Growth: 100/min, Enterprise: 1000/min)
  • Wait and retry with exponential backoff
  • Check the Retry-After response header
  • 500 Internal Server Error

  • This is a server-side issue — retry after 30 seconds
  • If persistent, check status.hciintel.com
  • Report to support@hciintel.com with your request details
  • 404 Not Found

  • Verify the endpoint URL is correct
  • Check that the resource ID (company, report) exists
  • See the API Docs page for correct endpoint paths
  • CORS Errors

    API calls must be made server-side. Browser-based (client-side) calls are blocked by CORS policy.

    Was this article helpful?