[metadata]
og:image: https://sentry-docs-8crvyypmm.sentry.dev/og.png
og:image:height: 630
og:image:width: 1200
og:title: Rate Limits
og:type: website
twitter:card: summary_large_image
twitter:image: https://sentry-docs-8crvyypmm.sentry.dev/og.png
twitter:image:height: 630
twitter:image:width: 1200
twitter:title: Rate Limits
viewport: width=device-width, initial-scale=1
zd-site-verification: ocu6mswx6pke3c6qvozr2e

[canonical-links]
https://docs.sentry.io/api/ratelimits/

[document-links]
AI: /ai/
API Reference: /api/
API: /api/
Authentication: /api/auth/
Crons: /api/crons/
Dashboards: /api/dashboards/
Discover & Performance: /api/discover/
Docs: /
Environments: /api/environments/
Events & Issues: /api/events/
Explore: /api/explore/
Go to Sentry: https://sentry.io/
Guides: /guides/
Home: /
Integration Platform: /api/integration/
Integrations: /api/integrations/
Mobile Builds: /api/mobile-builds/
Monitors & Alerts: /api/monitors/
Next Requests: /api/requests/
Organizations: /api/organizations/
Paginating Results: /api/pagination/
Permissions & Scopes: /api/permissions/
Previous Permissions & Scopes: /api/permissions/
Product Changelog: https://sentry.io/changelog/
Product: /product/
Profiling: /api/profiling/
Projects: /api/projects/
Rate Limits: /api/ratelimits/
Releases: /api/releases/
Replays: /api/replays/
Requests: /api/requests/
SCIM: /api/scim/
SDKs: /platforms/
Sandbox: https://sandbox.sentry.io/
Seer: /api/seer/
Snapshots: /api/snapshots/
Spike Protection Notifications: /api/spike-protection/
Teams: /api/teams/
Users: /api/users/
webhooks: /integrations/integration-platform/webhooks/

[content]
Rate Limits
Skip to content
Docs
SDKs
Product
AI
Guides
Concepts
API
Manage
Ask AI
Go to Sentry
Open Main Menu
API Reference
Authentication
Paginating Results
Permissions & Scopes
Rate Limits
Requests
Crons
Dashboards
Discover & Performance
Environments
Events & Issues
Explore
Integration Platform
Integrations
Mobile Builds
Monitors & Alerts
Organizations
Profiling
Projects
Releases
Replays
SCIM
Seer
Snapshots
Spike Protection Notifications
Teams
Users
Product Changelog
Sandbox
More
Home
API Reference
Rate Limits
Copy page
Rate Limits
Sentry rate limits every API request made to prevent abuse and resource overuse. The limit is applied to each unique combination of caller and endpoint.
We restrict both how frequently a request is made (requests per second rate limit) and how many concurrent requests a caller can make (concurrent rate limit).
The requests per second rate limit follows a fixed window approach. Requests are counted into time buckets, determined by the window size. If the number of requests from a caller exceeds the number of allowed requests within a window, then that request will be rejected. Each endpoint has its own maximum number of requests and window size.
Meanwhile, the concurrent rate limiter will reject requests if the caller has too many requests in progress at the same time.
You can track your rate limit usage by looking at special headers in the response.
Headers
Every API request response includes the following headers:
X-Sentry-Rate-Limit-Limit
The maximum number of requests allowed within the window
X-Sentry-Rate-Limit-Remaining
The number of requests this caller has left on this endpoint within the current window
X-Sentry-Rate-Limit-Reset
The time when the next rate limit window begins and the count resets, measured in UTC seconds from epoch
X-Sentry-Rate-Limit-ConcurrentLimit
The maximum number of concurrent requests allowed
X-Sentry-Rate-Limit-ConcurrentRemaining
The number of concurrent requests this caller has left
Additional Information
The rate limiter looks at the caller's identity instead of the bearer token or cookie. As such, the rate limit cannot be bypassed by generating multiple tokens.
Polling the API for updates is likely to quickly trigger rate limiting. We recommend using our
webhooks
, if possible.
Previous
Permissions & Scopes
Next
Requests
Was this helpful?
Yes 👍
No 👎
How can we improve this page?
Email
(optional)
Submit feedback
