Errors

Error response example

{ error: { code: 400022, messages: [ "ValidatorError :: Path `data.file_info.loaded_components` is invalid (a)." ] } }

Error Codes Explained

Group	Error code	Description	HTTP Code
HTTP errors :: 400	400000	Generic Error	400

Generic errors	400001	The caching strategy is not recognized	400
	400002	The limit strategy is not supported	400
	400003	The limit type is not supported	400
	400004	The query params are not valid	400
	400005	The URL params are not valid	400
	400006	Domain is not a valid origin.	400

Payload	400020	Header is not valid	400
	400021	Payload is not valid	400
	400022	Payload validation has failed	400
	400023	Headers are not correct	400
	400024	Headers are missing	400
	400025	Payload is missing or empty	400
	400026	Hash in the url doesn't match the hash value in the body	400
	400027	Offset should be a positive integer	400
	400028	Limit should be a positive integer less than 10000	400
	400029	Rescan is not available for sanitized files	400
	400030	Rescan is not available	400
	400031	Resource already exists	400

Routing errors	400040	The requested path is not valid	400
	400041	The version is required	400
	400042	The version does not exist	400
	400043	The requested path does not exist	400
	400044	Method does not exist	400
	400045	The route was not properly setup	400
	400046	The requested route does not exist	400
	400047	This route is available only on development environments	400
	400048	This route is deactivated	400

Hash errors	400060	The `hash` field in body is required	400
	400061	The `hash` field is not an array	400
	400062	The `hash` field is empty	400
	400063	Exceeded maximum allowed	400
	400064	The hash value is not valid	400
	400065	The header has to be either 0 or 1.	400
	400066	The header has to be either 0 or 1.	400
	400067	Hash update failed	400

Top hash URL errors	400080	Limit must be positive	400
	400081	Type must be one of `clean` / `infected`	400
	400082	Period must be one of `day` / `week` / `month`	400
	400083	Threshold must be one of 1, 2, 3, 4, 5, 6	400

App info	400100	The field `device_info.os_info.device_identity` is required	400
	400101	The fields `file_info.sha1`, `file_info.file_property.file_location`, `file_info.file_property.file_name` are required	400
	400102	Failed to save appinfo. Please try again later.	400

Top detection errors	400120	The header `x-exclude-empty-file-id` has to be either 0 or 1	400
	400121	The header `x-exclude-data` has to be either 0 or 1	400
	400122	The header `x-threshold` must be one of 1, 2, 3, 4, 5, 6	400
	400123	Packages should be one of m1, m4, m8, m12, m16, m20, mmax, mcl, mem, isv	400
	400124	Number of hashes must be one of 10, 100, 1000, 10000	400

Upload errors	400140	The file upload has failed.	400
	400141	The header has to be either 0 or 1.	400
	400142	The header has to be either 0, 1 or 2.	400
	400143	Private scanning not enabled for the provided API key.	400
	400144	Exceeded maximum file size allowed.	400
	400145	Request body is empty. Please send a binary file.	400
	400146	Provided download url is not valid or inaccessible.	400
	400147	Rescan Failed. Requested file is missing from our servers.	400
	400148	Requested file is a private one and cannot be rescanned.	400
	400149	Could not update the rescan count.	400
	400150	The `file_ids` field array in body is required	400
	400151	The `file_ids` field is not an array	400
	400152	The `file_ids` field is empty	400
	400153	Exceeded maximum allowed	400
	400154	Exceeded maximum allowed files in archive	400
	400155	Redirect urls are not supported	400
	400156	Workflow rule not available for your account	400

API key	400160	The apikey you are trying to add already exists	400
	400161	The apikey could not be removed	400
	400162	The apikey was not updated	400
	400163	The body is invalid	400
	400164	Please choose another nickname, as this one is too long	400
	400165	No apikey specified	400
	400166	Please provide a valid email address	400
	400167	Please provide a valid body	400
	400168	Please choose another nickname, as this one contains profanities	400
	400169	File type not allowed for vulnerability submission	400

User reputation	400170	The user's reputation could not be updated	400

IP-Domain errors	400180	Invalid format of the input. Provide IPv4 or IPv6	400
	400181	The `address` field in the body is required	400
	400182	The `address` field is not an array	400
	400183	The `address` field is empty	400
	400184	Exceeded maximum allowed	400
	400185	The address is a not a routable IP	400
	400186	No response	400

Stats	400200	The number of days requested must be a positive integer	400
	400201	Invalid objectId	400
	400202	Invalid date	400
	400203	Invalid outbreak report filter	400

Status	400210	Param type must be one of `prevention_api` / `reputation_api` / `feed_api`	400

Coupons	400220	Code not found	400
	400221	Code is inactive	400
	400222	This promotion has ended	400
	400223	Coupon update failed	400
	400224	Coupon already used	400
	400225	User already has an active coupon	400
	400226	Can not activate a coupon on a paid apikey	400

Repo	400240	Invalid `source` value	400
	400241	Invalid repository	400

Salesforce	400250	Salesforce connectivity error	400
	400251	There is no record	400

Feed	400260	You are allowed to query up to 30 days in the past	400
	400261	Invalid category. Please use: A, D, E, G, M, N, O, P, T, Z	400

Cognito	400262	App client name not provided	400
	400263	App client id not provided	400
	400264	Maximum number of app clients reached	400
	400265	App client could not be created	400
	400266	No client ids associated with current customer	400
	400267	Client id is not associated with current customer	400
	400268	Information about current app client could not be retrieved	400
	400269	App client could not be removed	400

HTTP errors :: 401	401000	Authentication has failed	401
	401001	Authentication strategy is invalid	401
	401002	Authentication strategy is not implemented	401
	401003	Authorization strategy is not supported for this endpoint	401
	401004	Authentication token has expired	401
	401005	Authentication token is invalid	401
	401006	Invalid API key	401
	401007	You are not authorized	401
	401008	You are not authorized to download this file	401

HTTP errors :: 403	403000	Access Forbidden	403
	403001	Requested resource doesn't match your API key	403
	403002	Your IP is blocked because of abuse and will be automatically unblocked in one hour. This is for preventing brute-force attacks.	403
	403003	Insufficient privileges	403

HTTP errors :: 404	404000	Endpoint not found	404
	404001	Entity was not found	404
	404002	There are no entries found	404
	404003	The hash was not found	404
	404004	The data_id was not found	404
	404005	The hash information was not found	404
	404006	There is no data for selected date	404
	404007	Requested file id does not exist in our records	404
	404008	The apikey was not found	404
	404009	Requested CVE does not exist in our records	404
	404010	Unsupported file type	404
	404011	This hash was scanned as a private file and we do not store the file	404
	404012	File was archived	404
	404013	This API version is no longer maintained. Please use V4 API https://onlinehelp.opswat.com/mdcloud/6._V4_API.html	404

HTTP errors :: 406	406000	Content-Type header & payload has to be json	406
	406001	Payload data missing or error	406

HTTP errors :: 408	408000	Request timeout. It has reached the 60 seconds limit	408

HTTP errors :: 429	429000	Rate limit exceeded, retry after the limit is reset.	429
	429001	Your request has been throttled, maximum requests per minute	429
	429002	Too many connections, try again later	429

HTTP errors :: 500	500000	Scan request has failed permanently.	500
	500001	Internal Server Error	500

HTTP errors :: 503	503000	External service is not reachable	503
	503001	External service is not reachable	503
	503002	Server is not accessible	503

Last updated on

Was this page helpful?