# Get a list of 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.

Endpoint: GET /data/events
Version: 1.0.1
Security: apikey

## Query parameters:

  - `instruments` (array, required)
    Serial numbers of selected instruments
    Example: ["QT123456","QT234567"]

  - `start` (string, required)
    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.
    Example: "2023-01-01T00:00:00Z"

  - `end` (string, required)
    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.
    Example: "2023-01-31T00:00:00Z"

## Response 200 fields (application/json):

  - `type` (string)

  - `name` (string)

  - `level` (integer)

  - `startTime` (string)

  - `endTime` (string)

  - `audioTime` (string,null)

  - `instrument` (string)

  - `overall` (array)

  - `octave` (array)

  - `thirdOctave` (array)

  - `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.

## Response 401 fields (application/json):

  - `error` (string)
    Error code

  - `description` (string)
    Description of the error

## Response 403 fields (application/json):

  - `error` (string)
    Error code

  - `description` (string)
    Description of the error

## Response 429 fields (application/json):

  - `error` (string)
    Error code

  - `description` (string)
    Description of the error