Token service error codes

Token Service Error Codes are a collection of error codes that are associated with the token service. These error codes are used to indicate specific issues or problems that may occur during the token generation process.

For any error code not documented here, please reach out to our support team and share the message and URL with us. We will immediately help investigate why this issue occured for you.

What does token-srv/token error Code xxx mean / What are the standard OAuth2 Error to retrieve a Token?

error	hint
invalid_request	This error indicates that the request is missing a required parameter, includes an unsupported parameter or parameter value, repeats the same parameter, uses more than one method for including an access token, or is otherwise malformed.
invalid_client	This error occurs when client authentication fails, such as if the client ID or secret is incorrect.
invalid_grant	This error is returned if the authorization code is invalid, expired, revoked, does not match the redirect URI used in the authorization request, or was issued to another client.
unauthorized_client	This error is issued when the authenticated client is not authorized to use the requested grant type.
unsupported_grant_type	This indicates that the authorization grant type is not supported by the authorization server.
authorization_pending	This error occurs when the client is polling the token endpoint to obtain an access token, but the user has not yet completed the authorization process. The client should continue to poll the token endpoint at the interval specified in the previous token response.

What does Token service error Code xxx mean?

cidaas returns error status codes on different occasion. To find out about the Token service related errors, you can navigate to the Token service error code page and lookup your retrieved error code. There you will also find useful hints how to solve them.

For example:

If you encounter this error code (TOKN1001,TOKN10005,TOKN10006,TOKN10007,TOKN10008,TOKN10009) in your application, you should follow the hint provided.

The following table represents the Token service error codes that will help you in identifying and troubleshooting various errors or failures.

code	error	error_description	hint
TOKN10001	invalid_request	request is missing a required parameter, client_id is missing	client_id is a required parameter that you need to pass in query
TOKN10002	empty_client_id	error creating verification url	there seems to be an error while creating a verification url
TOKN10003	invalid_request_body	error parsing request body	please check the query/form parameters you are passing are in correct format or is missing values
TOKN10004	invalid_device_request	error creating device request	please check the device details passed
TOKN10012	invalid_auth_header	invalid auth header passed. header must have 2 parts	auth header arguments missing
TOKN10013	invalid_access_token	invalid authorization header access_token passed	access token invalid
TOKN10014	invalid_authorization_header_type	invalid authorization header. should be either 'bearer' or 'basic'	invalid authorization type
TOKN10015	empty_access_token	access_token or id_token in body must not be empty	empty access token
TOKN10016	invalid_login_response	error while fetching login response from db for filter	login response failure
TOKN10017	login_response_not_found	login response not found for filter	login response invalid
TOKN10018	invalid_track_id	invalid track id passed	login response invalid
TOKN10019	getting_prevalidation_error	Error while getting pre-validation data from DB for track_id	pre-validation data not found
TOKN10020	updating_prevalidation_error	Error while updating pre-validation data to DB for track_id	pre-validation data update error
TOKN10021	metadata_error	Error initializing metadata	metadata error
TOKN10022	renew_request_body	Renew request body validation failed	renew request body failure
TOKN10023	sso_renew_failure	Login response not found for sso renew	sso renew failure
TOKN10024	invalid_token_type_hint	Invalid token type hint passed	token type hint failure
TOKN10025	invalid_request	request is missing a required parameter, client_id or client_secret is missing	client_id & client_secret is a required parameter that you need to pass in query
TOKN10027	invalid_client	client authentication failed : unknown client	client_id or client_secret is invalid
TOKN10030	failure_revoke_tokenby_sub	Error invoking token by sub	sub failure
TOKN10031	failure_revoke_tokenby_loginResponseId	Error revokin token by loginResponseId	loginResponseId failure
TOKN10032	token_validation_failed	Error while validating token request, might be invalid grant type, or missing client details	failed token validation
TOKN10033	authorization_code_grant_failure	Error while processing authorization code grant flow	grant type failure for authorization
TOKN10034	client_credentials_failure	Error while processing client credentials flow	grant type failure for client credentials
TOKN10035	password_grantype_failure	Error while processing passowrd grant type flow	failed password grant type failure
TOKN10036	implicit_grant_type_failure	Error while processing implicit grant type flow	failed implicit grant type failure
TOKN10037	standard_grant_type_failure	Error while processing stabdard grant type flow	failed standard grant type failure
TOKN10038	refresh_type_failure	Error while processing refresh token type flow	failed refresh token type failure
TOKN10039	device_grant_type_failure	Error while processing device grant type flow	failed device grant type failure
TOKN10040	device_grant_type_failure	Error while processing device grant type flow	failed device grant type failure
TOKN10041	missing_auth_request	Missing few auth parameters for processing the request	missing auth parameters
TOKN10043	invalid_token_passed	The passed token is invalid	invalid token
TOKN10044	client_authentication_failed	Client authentication failed while fetching client id from authcache	invalid token

Need Support?

Please contact us directly on our support page