---
title: "GET /events"
method: GET
path: "/events"
tags: ["events"]
---

# GET /events

`GET /events`

Returns a list of `Event` objects.

## Query parameters

- `start_date_filter` string
- `end_date_filter` string
- `actor_filter` string, uuid
- `object_filter` string, uuid
- `event_type_filter` string
- `api_token_filter` string
- `cursor` string
- `page_size` integer

## Response `200`

One page worth of events with the appropriate filters applied.

- PaginatedEventList
  - `next` string, nullable — The cursor with which to continue pagination if additional result pages exist.
  - `previous` string, nullable — The cursor used to obtain the current result page.
  - `results` Event[]
    - `event_id` string, uuid, required — The ID of the event.
    - `actor_user_id` string, uuid, required — The ID of the actor user.
    - `actor_name` string, string, required — The name of the actor user.
    - `actor_email` string — The email of the actor user.
    - `event_type` string, required — The event type.
    - `created_at` string, date-time, required — The day and time the event was created.
    - `actor_ip_address` string — The IP address of the event actor.
    - `api_token_name` string — The name of the API token used to create the event.
    - `api_token_preview` string — The preview of the API token used to create the event.
    - `sub_events` SubEvent[]
      - `sub_event_type` string, required — The subevent type.

---

[API](https://skmtc.net/opal/apis/opal-api.md) · [All operations](https://skmtc.net/opal/apis/opal-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/opal/opal-api/revisions/13b58df96d40/schema)