Raw events
Individual event payloads captured by the SDK. Each event contains a full stack trace, context, tags, and user information. Events are the atomic unit of data in Sentry.
Issues (groups)
Aggregations of events that share the same root cause (same fingerprint). Issues expose aggregate data like total counts, first seen, last seen, and affected users.
Key concepts
Events vs. issues
When your application sends an error to Sentry, a raw event is stored. Sentry then groups events with the same fingerprint into an issue (also called a group). The Issues API lets you work with these aggregations — resolving them, assigning them, and querying across your organization. The Events API gives you access to the underlying individual event payloads.Discover queries
The events query endpoint (GET /api/0/organizations/{org}/events/) supports Discover-style field selection and aggregations. Use this endpoint when you need to query events with custom fields, aggregations, or conditions across multiple projects.
Pagination
List endpoints return paginated results using cursor-based pagination. TheLink response header contains cursors for the next and previous pages:
cursor value as a query parameter to navigate to the next or previous page:
results="false" for the next cursor, you have reached the last page.
Rate limits
Event and issue endpoints are subject to the standard Sentry API rate limits. When you exceed the limit, the API returns429 Too Many Requests. Check the Retry-After response header for the number of seconds to wait before retrying.
Read Authentication for details on rate limit headers.
Error responses
| Status code | Meaning |
|---|---|
400 Bad Request | Your request body or query parameters are invalid |
401 Unauthorized | No token provided or the token is invalid |
403 Forbidden | Your token does not have the required scope |
404 Not Found | The requested resource does not exist |
429 Too Many Requests | Rate limit exceeded |
detail field explaining the error:
Available endpoints
Event queries
Query events with Discover-style field selection, filtering, and aggregations.
Event stats
Retrieve time-series event statistics for charts and dashboards.
Issues
List, update, and delete issues across your organization.
Raw events
Retrieve full event payloads including stack traces and context.