---
title: "List Events"
method: GET
path: "/api/v1/events"
tags: ["events"]
---

# List Events

`GET /api/v1/events`

## Request

- Base URL: `https://api.withverifa.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.withverifa.com/api/v1/events`
- Auth: none declared

List audit events for the authenticated organization with optional filters.

## Query parameters

- `action` string, nullable: Filter by exact event type (e.g. session.approved)
- `action_prefix` string, nullable: Filter by action prefix — matches 'prefix.*' (e.g. 'mcp' surfaces only MCP tool calls)
- `resource_type` string, nullable: Filter by resource type (e.g. session, identity)
- `resource_id` string, nullable: Filter by specific resource ID
- `created_after` string, date-time, nullable: Only events after this ISO 8601 timestamp
- `created_before` string, date-time, nullable: Only events before this ISO 8601 timestamp
- `q` string, nullable: Full-text search across actor, action, resource, IP
- `limit` integer
- `offset` integer

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/withverifa/apis/verifa.md) · [All operations](https://skmtc.dev/withverifa/apis/verifa/llms.txt) · [OpenAPI document](https://skmtc.dev/withverifa/apis/verifa/revisions/7288c82c9e33?raw)