---
title: "Query audit events in a time range"
method: GET
path: "/v1/events"
tags: ["Audit Events"]
---

# Query audit events in a time range

`GET /v1/events`

An endpoint for retrieving audit events in a time range

## Query parameters

- `from` string, date-time, required — The earliest date and time of audit events to retrieve. The date time format should be in ISO 8601 format, e.g.: 2025-02-20T07:15:15.000-01:00
- `to` string, date-time, required — The latest date and time of audit events to retrieve. The date time format should be in ISO 8601 format, e.g.: 2025-02-21T07:15:15.000-01:00
- `page` unknown
- `size` unknown

## Response `200`

Audit logs have been retrieved

- PagedResultListAugmentedAuditEventResponse
  - `page` integer — The 0-indexed page number of the returned results.
  - `results` AugmentedAuditEventResponse[] — Page of results or empty.
    - `actorEmail` string — Email address of the user who performed this action. Only available when the action was performed by a user with a valid email address.
    - `actorId` string — Identifier of the user or machine user that performed this action.
    - `additionalInfo` unknown
    - `eventDescription` string — A brief description of what happened.
    - `eventId` string, uuid, required — A unique identifier for this audit event.
    - `eventName` string — The specific action that was performed.
    - `eventProjectId` string, uuid — Project ID where this action occurred, if applicable.
    - `eventSource` string — The Matillion service where this action originated.
    - `eventSubjectId` string — Unique identifier of the resource affected by this action.
    - `eventSubjectName` string — Name of the resource affected by this action.
    - `eventSubjectType` string — Type of resource affected by this action (e.g., USER, PROJECT, SECRET).
    - `eventTimestamp` string, date-time — When this activity occurred, in UTC time.
    - `eventType` string — Category of the activity.
  - `size` integer — The size of each page of results.
  - `total` integer — Total number of available results across all pages.

## Other responses

- `400` — Wrong request parameters used
- `403` — Unauthorized
- `500` — Unexpected error occurred

---

[API](https://skmtc.net/maia/apis/maia-public-rest-api.md) · [All operations](https://skmtc.net/maia/apis/maia-public-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/maia/maia-public-rest-api/versions/6239825f68eb/schema)