# Fetch frequency bands measurements

Get noise frequency band measurements for the selected instruments and time range.

Optionally choose which bands and weighting to use and what period to recalculate results to.

The possible options are:
- Band
  - Octave - Includes all octave bands from 31.5Hz to 16KHz
  - Third - Includes all third octave bands from 6.3Hz to 20KHz
- Frequency Weighting
  - A
  - C
  - Z

 

If you specify an invalid or unavailable band or weighting, the server will respond with an error.
If no band or weighting are specified, the server will return the default results (Octave Z).

The maximum date range per request is 31 days. If you request a longer range, the server will respond with an error.
The default Period is the measurement period as configured in the instrument. See the settings for details.
The period can be set to anything between the measurement period and 1 day. If you request a period outside this range, the server will respond with an error.

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

Endpoint: GET /data/frequency/measurements
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"

  - `period` (string)
    Period to recalculate measurement samples to.

This cannot be less than the recorded measurement period.

This uses the ISO8601 duration format. For example, P1D is 1 day, PT1H is 1 hour, PT5M is 5 minutes.
    Example: "PT1H"

  - `bands` (string)
    Choose which set of frequency bands to use
    Enum: "Octave", "Third"

  - `weighting` (string)
    Choose which frequency weighting to apply to the results
    Enum: "A", "C", "Z"

## Response 200 fields (application/json):

  - `startTime` (string)

  - `endTime` (string)

  - `duration` (integer)

  - `instrument` (string)

  - `overload` (boolean)

  - `values` (array)

  - `values.name` (string)

  - `values.value` (number)

## 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