Error Reference
API Error CodesComplete Reference Guide
Understand HTTP status codes and how to resolve common API errors
400
Bad Request
The request was malformed or missing required parameters
Common Causes
- Missing required fields
- Invalid data format
- Incorrect data types
- Invalid enum values
How to Fix
- Verify all required fields are present
- Check JSON structure is valid
- Validate data types match API spec
- Review API documentation for field requirements
401
Unauthorized
Authentication failed or API key is invalid
Common Causes
- Missing API key
- Invalid API key
- Expired credentials
- Wrong environment key
How to Fix
- Include Authorization header with Bearer token
- Generate new API key from dashboard
- Use correct key for environment (test/prod)
- Verify key is active
403
Forbidden
Valid credentials but insufficient permissions
Common Causes
- Account suspended
- Feature not enabled
- IP not whitelisted
- Scope restrictions
How to Fix
- Contact support to verify account status
- Check feature flags in dashboard
- Add IP to whitelist
- Request additional API scopes
404
Not Found
The requested resource doesn't exist
Common Causes
- Invalid resource ID
- Resource deleted
- Incorrect endpoint URL
- Typo in path
How to Fix
- Verify resource ID is correct
- Check if resource was deleted
- Confirm endpoint URL matches docs
- Review API version in URL
422
Unprocessable Entity
Request understood but cannot be processed due to validation errors
Common Causes
- Business logic validation failed
- Duplicate resource
- Invalid state transition
- Constraint violation
How to Fix
- Review validation errors in response
- Check business rule requirements
- Verify no duplicate entries
- Ensure valid state transitions
429
Too Many Requests
Rate limit exceeded
Common Causes
- Too many requests in time window
- Concurrent request limit hit
- No exponential backoff
How to Fix
- Implement rate limiting in your code
- Add exponential backoff retry logic
- Cache responses where possible
- Contact support for higher limits
500
Internal Server Error
Something went wrong on our servers
Common Causes
- Server-side bug
- Database issue
- Third-party service down
- Temporary glitch
How to Fix
- Retry request after brief delay
- Check status page for incidents
- Contact support with request ID
- Implement retry logic with backoff
503
Service Unavailable
Service temporarily unavailable
Common Causes
- Scheduled maintenance
- System overload
- Deployment in progress
How to Fix
- Check status page
- Wait and retry
- Implement graceful degradation
- Subscribe to status updates
Error Response Format
{
"error": {
"code": "invalid_request",
"message": "Missing required field: activity_type",
"type": "validation_error",
"param": "activity_type",
"request_id": "req_abc123"
}
}