# Event data

Endpoints for retrieving historic event data

## Get a list of events

 - [GET /data/events](https://mycirrus.redocly.app/apis/mycirrus-main/event-data/getevents.md): Get a list of events for the selected instruments and time range.

The maximum date range per request is 31 days. If you request a longer range, the server will respond with an error.

Requires an API key with the data.events:read scope.

## Get event time history

 - [GET /data/events/timehistory/{id}](https://mycirrus.redocly.app/apis/mycirrus-main/event-data/geteventtimehistory.md): Get time history data for the given noise event.

Requires an API key with the data.events:read scope.

## Get event audio recording

 - [GET /data/events/audio/{id}](https://mycirrus.redocly.app/apis/mycirrus-main/event-data/geteventaudio.md): Get the audio recording for the given noise event.

Requires an API key with the data.events:read and data.audio:read scopes.