Throttling

Throttling refers to the practice of limiting requests to endpoints after a certain threshold is reached. Our throttling mechanism allows up to:

• 9 requests/hour for free users and a limit of 45 scans per day with a personal license
• 75 requests/minute for paid users with a standard license
• 150 requests/minute for paid users with a professional license
• 500+ requests/minute for paid users with an enterprise license

There are certain endpoints in MetaDefender Cloud that can be throttled:

• Scanning a file by file uploadAPI
• Data Sanitization RequestAPI
• Retrieving scan reports for multiple data hashesAPI
• Scanning list of IPsAPI
• Scanning list of URLsAPI
• Scanning list of domainsAPI

To the above endpoints. If a user exceeds the allowed values, the requests will be blocked, and an HTTP response code of 429 will be returned.

"error": {

  "name": "ClientError",

  "messages": "Your request has been throttled, maximum requests per hour: 9 for free users",

  "code": 429001,

  "status": 429

   }

In such cases, please limit the number of requests sent per minute.

If you have inadvertently reached the limit and need assistance in identifying the cause of being throttled, please contact OPSWAT Support.