Get historical air quality data for one device

GET

/devices/{id}/historical

const url = 'https://localhost:8080/api/v1/devices/example/historical?timeline=daily';
const options = {method: 'GET', headers: {Authorization: '<Authorization>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://localhost:8080/api/v1/devices/example/historical?timeline=daily' \
  --header 'Authorization: <Authorization>'

Same as /air-quality/historical but restricted to a single device

Authorizations

BearerAuth

Parameters

Path Parameters

required

string

Device id (UUID)

Query Parameters

timeline

required

string

Allowed values: daily weekly monthly yearly

Timeline

Responses

200

application/json

object

data

Array<object>

object

label

string

metrics

object

aqi

integer

heat_index

number

humidity

number

pm1_0

number

pm2_5

number

pm10_0

number

temperature

number

timestamp

string

timeline

string

Example

{
  "timeline": "daily"
}

401

Unauthorized

application/json

object

detail

string

errors

Array<object>

object

code

string

detail

string

Allowed values: body query path

name

string

instance

string

status

integer

title

string

type

string

Example

{
  "detail": "One or more request values are invalid.",
  "errors": [
    {
      "code": "required",
      "detail": "name is required",
      "in": "body",
      "name": "name"
    }
  ],
  "instance": "/api/v1/devices",
  "status": 422,
  "title": "Request validation failed",
  "type": "https://docs.air-iq.net/reference/errors/#validation-error"
}

404

Not Found

application/json

object

detail

string

errors

Array<object>

object

code

string

detail

string

Allowed values: body query path

name

string

instance

string

status

integer

title

string

type

string

Example

{
  "detail": "One or more request values are invalid.",
  "errors": [
    {
      "code": "required",
      "detail": "name is required",
      "in": "body",
      "name": "name"
    }
  ],
  "instance": "/api/v1/devices",
  "status": 422,
  "title": "Request validation failed",
  "type": "https://docs.air-iq.net/reference/errors/#validation-error"
}

422

Unprocessable Entity

application/json

object

detail

string

errors

Array<object>

object

code

string

detail

string

Allowed values: body query path

name

string

instance

string

status

integer

title

string

type

string

Example

{
  "detail": "One or more request values are invalid.",
  "errors": [
    {
      "code": "required",
      "detail": "name is required",
      "in": "body",
      "name": "name"
    }
  ],
  "instance": "/api/v1/devices",
  "status": 422,
  "title": "Request validation failed",
  "type": "https://docs.air-iq.net/reference/errors/#validation-error"
}

500

Internal Server Error

application/json

object

detail

string

errors

Array<object>

object

code

string

detail

string

Allowed values: body query path

name

string

instance

string

status

integer

title

string

type

string

Example

{
  "detail": "One or more request values are invalid.",
  "errors": [
    {
      "code": "required",
      "detail": "name is required",
      "in": "body",
      "name": "name"
    }
  ],
  "instance": "/api/v1/devices",
  "status": 422,
  "title": "Request validation failed",
  "type": "https://docs.air-iq.net/reference/errors/#validation-error"
}