Errors & Rate Limits
HTTP status codes, error response format, and rate-limiting headers.
HTTP Status Codes
Error Response Format
Error Responsejson
{"success": false,"error": {"code": "VALIDATION_ERROR","message": "Invalid request body","details": [{"field": "email","message": "Must be a valid email address"}]}}
Authentication Errorjson
{"success": false,"error": {"code": "UNAUTHORIZED","message": "Invalid or expired access token"}}
Rate Limit Errorjson
{"success": false,"error": {"code": "RATE_LIMITED","message": "Too many requests. Please retry after 42 seconds.","retryAfter": 42}}