# Fetch noise time history

Get noise time history for the selected instruments and time range.

Optionally choose which values to include and what period to recalculate results to.


The maximum date range per request is 7 days. If you request a longer range, the server will respond with an error.
The default Period is 1 second.
The period can be set to anything between the current time history setting and 1 minute. If you request a period outside this range, the server will respond with an error.
You can request data with a period of less than 1 second by using a fractional seconds value in the period. For example, PT0.1S for 100ms.

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

Endpoint: GET /data/noise/timehistory
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 time history samples to.

This cannot be less than the recorded time history period.

This uses the ISO8601 duration format. For example, PT1H is 1 hour, PT1M is 1 minute, PT1S is 1 second.
    Example: "PT1H"

  - `values` (array)
    Names of selected values to include in results
    Example: ["LAeq","LCPeak","LAFMax"]

## Response 200 fields (application/json):

  - `instrument` (string)

  - `type` (string)

  - `blocks` (array)

  - `blocks.start` (string)

  - `blocks.end` (string)

  - `blocks.sampleDuration` (number)

  - `blocks.values` (array)

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