Errors

Standard Error Response

The Authentication API may return the following HTTP status codes with corresponding error responses. Each status code includes a JSON response that provides more details about the error.

400 Bad Request

Description	JSON Response
Invalid request	{"error": "invalid_request", "error_description": "..."}
Invalid scope format (must be an array or string)	{"error": "invalid_scope", "error_description": "Scope must be an array or a string"}

401 Unauthorized

Description	JSON Response
Invalid client credentials	{"error": "invalid_client", "error_description": "..."}
Suspicious request requires validation	{"error": "requires_validation", "error_description": "Suspicious request requires verification"}

403 Forbidden

Description	JSON Response
Unauthorized client	{"error": "unauthorized_client", "error_description": "..."}
Access denied	{"error": "access_denied", "error_description": "..."}
Invalid or unknown refresh token	{"error": "access_denied", "error_description": "Unknown or invalid refresh token"}
Invalid grant	{"error": "invalid_grant", "error_description": "..."}

404 Not Found

Description	JSON Response
Endpoint is disabled	{"error": "endpoint_disabled", "error_description": "..."}

405 Method Not Allowed

Description	JSON Response
HTTP method not allowed	{"error": "method_not_allowed", "error_description": "..."}

429 Too Many Requests

Description	JSON Response
Too many requests	{"error": "too_many_requests", "error_description": "..."}

500 Internal Server Error

Description	JSON Response
General server error	(No specific response format)

501 Not Implemented

Description	JSON Response
Unsupported response type	{"error": "unsupported_response_type", "error_description": "..."}
Unsupported grant type	{"error": "unsupported_grant_type", "error_description": "..."}

503 Service Unavailable

Description	JSON Response
Service temporarily unavailable	{"error": "temporarily_unavailable", "error_description": "..."}

---