---
title: "List tenant audit events"
method: GET
path: "/audit/events"
tags: ["Audits"]
---

# List tenant audit events

`GET /audit/events`

Requires an owner/admin browser session with recent MFA. Supports exact action filters, action-prefix filters for wallet/action history views, exact actor/resource/request filters, date ranges, pagination, and up to five exact metadata filters using dot-path query keys such as `metadata.adapter.kind=swap`.

## Query parameters

- `action` string
- `actionPrefix` string
- `actorType` string
- `actorId` string
- `resourceType` string
- `resourceId` string
- `requestId` string
- `metadata.<path>` string — Exact metadata filter. Replace <path> with a dot-separated JSON metadata path, for example metadata.adapter.kind=swap. Up to five filters are accepted.
- `dateFrom` string, date-time
- `dateTo` string, date-time
- `page` integer
- `limit` integer

## Response `200`

JSON response

- object
  - `ok` true, required
  - `data` object, required
    - `data` object[], required
      - `id` string, required
      - `seq` integer, required
      - `actor_type` string, nullable, required
      - `actor_id` string, nullable, required
      - `action` string, required
      - `resource_type` string, nullable, required
      - `resource_id` string, nullable, required
      - `metadata` object, required
      - `ip_address` string, nullable
      - `user_agent` string, nullable
      - `request_id` string, nullable
      - `created_at` string, date-time, required
    - `pagination` object, required
      - `page` integer, required
      - `limit` integer, required
      - `total` integer, required
      - `totalPages` integer, required

## Other responses

- `400` — JSON response
- `401` — JSON response
- `403` — JSON response
- `404` — JSON response
- `409` — JSON response

## Changes

- **2026-08-17** `261a7c8070b2` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/steward-fi/apis/steward-api/changes/audit/events/get.md)

---

[API](https://skmtc.dev/steward-fi/apis/steward-api.md) · [All operations](https://skmtc.dev/steward-fi/apis/steward-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/steward-fi/steward-api/revisions/b88b4b97a664/schema)