Error Handling

The request contains invalid parameters or is malformed.

{"error": "invalid_request", "error_description": "Missing required parameter"}

The token is invalid or expired, or authentication is missing.

{"error": "invalid_token", "error_description": "Token expired or invalid"}

Access denied. The user may have revoked access or the account is banned/suspended.

{"error": "access_denied", "error_description": "Account banned"}

You exceeded the rate limit. Wait before retrying.

{"error": "rate_limit_exceeded", "error_description": "Too many requests"}

Cengel ID returns errors as query parameters in the redirect URI:

?error=ERROR_CODE&error_description=DESCRIPTION&state=YOUR_STATE

Error Code	Type	Description
invalid_request	string	Request is missing a required parameter
unauthorized_client	string	Client is not authorized to use this flow
access_denied	string	User denied the authorization request
invalid_scope	string	Requested scope is invalid or unknown
server_error	string	Internal server error occurred

The API returns errors as JSON in the response body:

{
  "error": "invalid_grant",
  "error_description": "Authorization code expired"
}

Error Code	Type	Description
invalid_request	string	Request is missing a required parameter
invalid_client	string	Client authentication failed
invalid_grant	string	Authorization code is invalid or expired
unauthorized_client	string	Client is not authorized to use this grant type
unsupported_grant_type	string	Grant type is not supported

Menu