> ## Documentation Index > Fetch the complete documentation index at: https://docs.coval.ai/llms.txt > Use this file to discover all available pages before exploring further. # List alert events > Returns evaluation events for an alert, ordered by most recent first. Every run completion that evaluates this alert produces an event, regardless of outcome (TRIGGERED, NOT_MET, SUPPRESSED, ERROR). ## OpenAPI ````yaml /api-reference/v1/alerts-v1.yaml get /alerts/{alert_id}/events openapi: 3.0.3 info: title: Coval Alerts API version: 1.0.0 description: | API for managing alerts — metric-based alerting rules that evaluate on run completion and dispatch notifications to configured channels. Alerts support: - Per-run metric checks (single value, run average, run fraction) - AND/OR condition logic across multiple metrics - Multi-channel notifications (Slack, email, webhook, human review) - Cooldown/deduplication - Custom message templates contact: name: Coval API Support email: support@coval.dev url: https://docs.coval.ai license: name: Proprietary url: https://coval.dev/terms servers: - url: https://api.coval.dev/v1 security: - ApiKeyAuth: [] tags: - name: Alerts description: CRUD operations for alert definitions - name: Alert Events description: Alert evaluation event history paths: /alerts/{alert_id}/events: get: tags: - Alert Events summary: List alert events description: | Returns evaluation events for an alert, ordered by most recent first. Every run completion that evaluates this alert produces an event, regardless of outcome (TRIGGERED, NOT_MET, SUPPRESSED, ERROR). operationId: listAlertEvents parameters: - $ref: '#/components/parameters/AlertId' - name: outcome in: query schema: type: string enum: - TRIGGERED - NOT_MET - SUPPRESSED - ERROR description: Filter events by outcome - name: page_size in: query schema: type: integer minimum: 1 maximum: 100 default: 50 description: Number of results per page - name: page_token in: query schema: type: string description: Token for fetching the next page of results responses: '200': description: List of alert events content: application/json: schema: $ref: '#/components/schemas/ListAlertEventsResponse' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/PermissionDenied' '404': $ref: '#/components/responses/NotFound' '500': $ref: '#/components/responses/InternalError' components: parameters: AlertId: name: alert_id in: path required: true schema: type: string pattern: ^[0-9A-Z]{26}$ description: Alert ULID example: 01HZ0EXAMPLE00000000000000 schemas: ListAlertEventsResponse: type: object required: - events - total_count properties: events: type: array items: $ref: '#/components/schemas/AlertEventResource' next_page_token: type: string nullable: true total_count: type: integer AlertEventResource: type: object required: - ulid - alert_ulid - run_id - outcome - created_at properties: ulid: type: string pattern: ^[0-9A-Z]{26}$ description: Event ULID alert_ulid: type: string description: Alert ULID that produced this event run_id: type: string description: Run that triggered evaluation outcome: $ref: '#/components/schemas/AlertEventOutcome' condition_results: type: array items: type: object properties: metric_id: type: string metric_display_name: type: string aggregation: type: string computed_value: oneOf: - type: number - type: string nullable: true threshold: oneOf: - type: number - type: string nullable: true operator: type: string met: type: boolean description: Per-condition evaluation results dispatched_channels: type: array items: type: object properties: channel_type: type: string channel_summary: type: string success: type: boolean error: type: string nullable: true description: Per-channel dispatch results message_sent: type: string nullable: true description: Notification message that was dispatched created_at: type: string format: date-time description: Event creation timestamp ErrorResponse: type: object required: - error properties: error: type: object required: - code - message - details properties: code: type: string enum: - INVALID_ARGUMENT - UNAUTHENTICATED - PERMISSION_DENIED - NOT_FOUND - ALREADY_EXISTS - INTERNAL message: type: string description: Human-readable error message details: type: array items: type: object properties: field: type: string nullable: true description: type: string AlertEventOutcome: type: string enum: - TRIGGERED - NOT_MET - SUPPRESSED - ERROR description: Outcome of an alert evaluation responses: Unauthorized: description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: UNAUTHENTICATED message: Authentication failed details: - field: X-API-Key description: Invalid or missing API key PermissionDenied: description: Permission Denied content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: PERMISSION_DENIED message: Insufficient permissions details: - field: permissions description: 'Required scope: alerts:read' NotFound: description: Not Found content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: NOT_FOUND message: Alert not found details: - field: alert_id description: Alert '01HZ0EXAMPLE00000000000000' not found InternalError: description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: INTERNAL message: Internal server error details: - description: An unexpected error occurred securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key description: API key for authentication ````