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

# List events

`GET /events`

## Request

- Base URL: `https://my.demio.com/api/v1`
- URL: `https://my.demio.com/api/v1/events`
- Auth: API key in header `Api-Key` and API key in header `Api-Secret`

Returns your events, each collapsed to a single representative
date. Ordered by date, ascending.

## Query parameters

- `type` 'upcoming' | 'past' | 'automated'

## Response `200`

The matching events.

- EventSummary[]
  - `id` integer, required
  - `labeled_name` string: The name prefixed with the event's type, for display.
  - `name` string, required
  - `description` string, nullable
  - `date_id` integer, required: The representative date for this event.
  - `status` string, required: The status of that date.
  - `timestamp` integer, required: When that date starts, as a Unix timestamp.
  - `zone` string: The date's IANA time zone.
  - `registration_url` string, uri, required: The event's public registration page.
  - `automated` Automated, nullable: Present for an automated event, null otherwise.
    - `ready` boolean, required: True when the recording or video is ready to play.
    - `duration` integer, required: Length in seconds; zero until it is ready.

## Other responses

- `401`: The credentials were missing or rejected.
- `403`: The account is not active, or the id in the path is not one your account may read. An id that does not exist answers here too, so the API does not reveal whether it exists.
- `417`: The per-minute request rate or the account's daily API allowance was exceeded.
- `500`: Something failed on our side. The message is always generic; no internal detail is returned.

---

[API](https://skmtc.dev/demio/apis/public-demio-api.md) - [All operations](https://skmtc.dev/demio/apis/public-demio-api/llms.txt) - [OpenAPI document](https://skmtc.dev/demio/apis/public-demio-api/revisions/619f81d5263f?raw)