> ## Documentation Index > Fetch the complete documentation index at: https://docs.range.org/llms.txt > Use this file to discover all available pages before exploring further. # List Alert Events > Returns a cursor-paginated list of the workspace alert events, newest first. ## OpenAPI ````yaml get /v1/risk/alert-events openapi: 3.0.0 info: title: Range Risk API description: The Range Risk API for risk assessment of crypto addresses. version: 1.7.8 contact: {} servers: - url: https://api.range.org description: Range API Server security: - Authorization: [] tags: - name: Risk description: Get risk information about a crypto address. - name: Risk v2 description: >- Address risk assessment, workspace configuration, and signals catalogue (API v2). - name: Simulator description: Simulate a transaction on a network. - name: Alert Templates description: Browse alert rule templates available to the workspace. - name: Alert Rules description: Create and manage workspace alert rules. - name: Alert Events description: List and retrieve fired alert events. - name: Channels description: Configure alert delivery channels. paths: /v1/risk/alert-events: get: tags: - Alert Events summary: List alert events for the workspace description: >- Returns a cursor-paginated list of the workspace alert events, newest first. Filter by network, severity, resolution status, transaction hash, date range, or full-text search. Use `meta.next_cursor` / `meta.previous_cursor` to navigate pages. operationId: listEvents parameters: - name: limit required: false in: query description: Maximum number of records to return (1-100). Defaults to 10. schema: minimum: 1 maximum: 100 default: 10 example: 20 type: number - name: cursor required: false in: query description: >- Opaque pagination cursor. Omit for the first page, then pass `meta.next_cursor` / `meta.previous_cursor` from a previous response to move between pages. `meta.first_page_cursor` (`A`) and `meta.last_page_cursor` (`Z`) jump to the first/last page. Results are ordered newest-first by a server-side cursor; treat the value as opaque — do not construct or modify it. schema: example: eyJwIjoyLCJjIjoiMjkxNzM0NDYyNDg0NDM0OTk1MyIsImIiOmZhbHNlfQ type: string - name: network required: false in: query description: Filter by network slug (e.g. `ethereum`, `solana`). schema: example: ethereum type: string - name: tx_hash required: false in: query description: Filter by exact transaction hash. schema: example: 0xabc123...def456 type: string - name: start_date required: false in: query description: Start of date range in `YYYY-MM-DD` format (inclusive, UTC). schema: example: '2026-05-01' type: string - name: end_date required: false in: query description: End of date range in `YYYY-MM-DD` format (inclusive, UTC). schema: example: '2026-05-31' type: string - name: severity required: false in: query description: >- Comma-separated list of severity levels to filter by (e.g. `low,medium,high`). schema: example: high,medium type: string - name: search_string required: false in: query description: Case-insensitive search across event caption and addresses involved. schema: example: '0x742d35' type: string responses: '200': description: '' content: application/json: schema: $ref: '#/components/schemas/ListAlertEventsResponseDto' components: schemas: ListAlertEventsResponseDto: type: object properties: items: type: array items: $ref: '#/components/schemas/AlertEventListItemDto' meta: $ref: '#/components/schemas/CursorMetaDto' required: - items - meta AlertEventListItemDto: type: object properties: id: type: string description: Unique identifier of the alert event. example: clxyz1234abcd time: type: string description: ISO 8601 timestamp of when the on-chain event occurred. example: '2026-05-10T14:22:00.000Z' tx_hash: type: string nullable: true description: Transaction hash associated with the event. example: 0xabc123...def456 block_number: type: number nullable: true description: Block number at which the event was detected. example: 19823401 network: type: string description: Network slug where the event occurred. example: ethereum alert_rule_id: type: string nullable: true description: ID of the alert rule that produced this event. example: '7890123456789012' addresses_involved: description: List of blockchain addresses involved in the event. example: - '0x742d35Cc6634C0532925a3b844Bc9e7595f2bD28' type: array items: type: string created_at: type: string description: ISO 8601 timestamp of when the event record was created. example: '2026-05-10T14:22:05.000Z' details: type: object description: Arbitrary structured data specific to the event type. example: amount: 5000000 token: USDC from: '0x742d35Cc6634C0532925a3b844Bc9e7595f2bD28' to: 0xAbC...123 severity: type: string description: Risk severity of the event. example: high enum: - low - medium - high caption: type: string description: Human-readable caption describing the event. example: Large USDC transfer detected required: - id - time - network - addresses_involved - created_at - details - severity - caption CursorMetaDto: type: object properties: next_cursor: type: string nullable: true description: >- Opaque string cursor pointing to the next page of results. null if there is no next page. example: eyJpZCI6IjkxeFFlV3Z... previous_cursor: type: string nullable: true description: >- Opaque string cursor pointing to the previous page of results. null if there is no previous page. example: eyJpZCI6IjkxeFFlV3Z... first_page_cursor: type: string description: >- Opaque string cursor pointing to the very first page in the entire dataset with respect to the current filter. example: eyJpZCI6IjkxeFFlV3Z... last_page_cursor: type: string nullable: true description: >- Opaque string cursor pointing to the very last page in the entire dataset with respect to the current filter. example: eyJpZCI6IjkxeFFlV3Z... total_count: type: number nullable: true description: Total number of results. example: 100 page_number: type: number description: Current page number. example: 1 securitySchemes: Authorization: scheme: bearer bearerFormat: API Key description: 'Use Authorization: Bearer ' type: http ````