# Get a list of events

**GET /data/events**

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.


## Servers
- Production server: https://api.mycirrus.cloud/v1 (Production server)



## Parameters


### Query parameters
- **instruments** (array[string])
  Serial numbers of selected instruments
- **start** (string(date-time))
  Start date and time for loading a range of data. Must be in UTC.

  This uses the ISO8601 format. For example, `2023-01-01T00:00:00Z` is 1st January 2023 at midnight UTC.
- **end** (string(date-time))
  End date and time for loading a range of data. Must be in UTC.

  This uses the ISO8601 format. For example, `2023-01-01T00:00:00Z` is 1st January 2023 at midnight UTC.


## Responses
### 200
OK

#### Body: application/json (array[object])
- **type** (string)

- **name** (string)

- **level** (integer)

- **startTime** (string(date-time))

- **endTime** (string(date-time))

- **audioTime** (string | null)

- **instrument** (string)

- **overall** (array[number])

- **octave** (array[number])

- **thirdOctave** (array[number])

- **timeHistoryId** (string)
  ID of the time history data for this event. Used to download the time history data.
- **audioId** (string)
  ID of the audio data for this event. Used to download the audio data.

### 401
Your access token is invalid or has expired

#### Body: application/json (object)
- **error** (string)
  Error code
- **description** (string)
  Description of the error

### 403
You do not have permission to access this data

#### Body: application/json (object)
- **error** (string)
  Error code
- **description** (string)
  Description of the error

### 429
You have made too many requests in a short time

#### Body: application/json (object)
- **error** (string)
  Error code
- **description** (string)
  Description of the error


[Powered by Bump.sh](https://bump.sh)