API Rate Limits

VeriSwarm enforces rate limits to ensure platform stability and fair usage.

Default Limits

Endpoint	Free	Pro	Max	Enterprise
Event ingestion	100/min	1,000/min	5,000/min	Custom
Decision checks	100/min	1,000/min	5,000/min	Custom
Score queries	60/min	300/min	1,000/min	Custom
Agent registration	20/min	30/min	30/min	Custom
Widget chat	30/min per IP	30/min per IP	30/min per IP	Custom

Rate Limit Headers

Every API response includes rate limit headers:

• X-RateLimit-Limit -- Maximum requests allowed in the window
• X-RateLimit-Remaining -- Requests remaining in the current window
• X-RateLimit-Reset -- Unix timestamp when the window resets

When You Hit a Limit

• HTTP 429 Too Many Requests is returned
• The response includes a Retry-After header (seconds)
• No overage charges -- requests are simply rejected
• Rate limits reset every 60 seconds

Increasing Your Limits

• Pro/Max plans have higher default limits
• Enterprise plans can request custom limits
• Contact support@veriswarm.ai for limit adjustments

IP Allowlisting

Enterprise customers can restrict API access to specific IP ranges via Account > Settings > IP Allowlist. When configured, only requests from the specified CIDR ranges will be accepted on event ingestion and decision check endpoints. All other requests receive a 403 response.