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

# List events

`GET /events`

## Request

- Base URL: `https://app.italic.com/api/v2`
- URL: `https://app.italic.com/api/v2/events`
- Auth: HTTP bearer

Required permission: events:read.

## Query parameters

- `cursor` string
- `limit` integer

## Response `200`

Success. Writes without read permission return an ID and revision only.

- EventList
  - `events` Event[], required
    - `id` integer, required
    - `type` 'recording.created' | 'recording.updated' | 'recording.deleted', required
    - `recordingId` string, required
    - `revision` integer, required
    - `createdAt` integer, required
  - `nextCursor` string, required

## Other responses

- `default`: Request failed. Errors include a stable code and a readable message.

---

[API](https://skmtc.dev/italic/apis/italic-api.md) - [All operations](https://skmtc.dev/italic/apis/italic-api/llms.txt) - [OpenAPI document](https://skmtc.dev/italic/apis/italic-api/revisions/2fbe2cf16fe3?raw)