Error Codes

The following are the most common errors that may occur in response to an API call even if your implementation is correct.

All application-level errors are indicated as HTTP 400 errors and negative integer values in the response body status code. HTTP status codes are set; errors: 4xx codes are for developer- or user-related errors, and 5xx codes are for internal service errors, and the status will be 2xx in non-error cases.

Example

{ 
 "id": "QCZEQ1730079228140"
 "utctime": "2024-10-28T01:33:48.922799Z"
 "code": 400 
 "status":-5075,
 "message": "BAD REQUEST :- PARSING CHALLENGE BODY JSON FAILED"
 "more info": "https://support.gridy.io/errors?code=-5075"
}

See list of common API error codes below:

   

Http Status		API Status	Description
400	Bad Request
		-1001	API User validation error
		-1003	API User validation error
		-1026	API User permissions error
		-2003	Account validation error
		-2004	Account blocked
		-2005	Account too many failed attempts
		-2006	Account locked
		-2007	Account disabled
		-2008	Account not active
		-2009	Account locked
		-2010	Account temporarily disabled
		-2017	Account lock enabled
		-2038	Account lockdown activated
		-2035	Challenge cancelled error
		-4004	HTTP Header x-gridy-utctime missing
		-4005	HTTP Header x-gridy-utctime format error
		-4006	HTTP Header x-gridy-cnonce missing
		-4007	HTTP Header x-gridy-cnonce format error
		-4008	HTTP Header x-gridy-apiuser missing error
		-4009	HTTP Header x-gridy-apiuser format error
		-4000	HTTP Authorization Header missing
		-4001	HTTP Authorization Header format error
		-4026	HTTP Authorization Header HMAC signature missing
		-4027	HTTP Authorization Header HMAC signature format error
		-4028	HTTP Authorization Header HMAC apiuser missing error
		-4029	HTTP Authorization Header HMAC apiuser format error
		-4030	HTTP Authorization Header HMAC algorithm missing error
		-4031	HTTP Authorization Header HMAC algorithm format error
		-4032	HTTP Authorization Header HMAC headers missing error
		-4033	HTTP Authorization Header HMAC headers format error
		-4034	HTTP Authorization Header HMAC cnonce reused error
		-4035	HTTP Authorization Header HMAC timestamp reused error
		-4036	HTTP Authorization Header HMAC utctime clock drift error
		-4037	HTTP Authorization Header HMAC signature error
		-5070	API Request JSON Null body error
		-5071	API Request JSON body type error
		-5072	API Request JSON body type unknown error
		-5075	API Challenge Request body error
		-5076	API Challenge Request challenge type error
		-5077	API Challenge Request body missing User error
		-5078	API Challenge Request body missing challenge type error
		-5079	API Challenge Request body invalid email address error
		-6021	API request blocked - IP address location blocked based on user defined rules
500	Internal Error	-5000	API request rejected due to an Internal error.