---
title: "Get an event with its dates"
method: GET
path: "/event/{id}"
tags: ["Events"]
---

# Get an event with its dates

`GET /event/{id}`

## Request

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

## Path parameters

- `id` integer, required

## Query parameters

- `active` 'true' | 'false'

## Response `200`

The event and its dates.

- Event: One event with every date the filter allowed.
  - `id` integer, required
  - `name` string, required
  - `description` string, nullable
  - `registrants_stay_registered` boolean: True when registering once covers the whole series.
  - `registration_url` string, uri, required
  - `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.
  - `next_date_id` integer, nullable, required: The first date that has not finished, if any.
  - `dates` EventDate[], required
    - `date_id` integer, required
    - `status` string, required
    - `timestamp` integer, nullable: When the date starts, as a Unix timestamp. Null for an on-demand date.
    - `datetime` string, nullable: The start time already formatted in the date's zone. Null for an on-demand date.
    - `zone` string, nullable: The date's IANA time zone. Null for an on-demand date.

## 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.
- `404`: The event is yours, but no date matched. Sending `active=true` against an event whose dates have all finished answers here. An id you may not read answers `403` instead.
- `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)