List all measurements

warning

Please read the note on the calculation of grades for measurements here.

GET

https://dev.breeze-technologies.de/api/v3/sensors/all/measurements/latest

Returns a list of the latest measurements for all the sensors that your account has access to.

cURL

GET /api/v3/sensors/all/measurements/latest

curl -X GET \
    'https://dev.breeze-technologies.de/api/v3/sensors/all/measurements/latest' \
    -d api_token=<YOUR_API_TOKEN> \
    -d aggregation='' \
    -d key=''

Python

GET /api/v3/sensors/all/measurements/latest

import requests

url = "https://dev.breeze-technologies.de/api/v3/sensors/all/measurements/latest"

params = {
    "api_token": "<YOUR_API_TOKEN>",
    "aggregation": "", # optional
    "key": "" # optional
}

response = requests.request("GET", url, params=params)

print(response.text)

Javascript

GET /api/v3/sensors/all/measurements/latest

const axios = require("axios");

let config = {
  method: "get",
  maxBodyLength: Infinity,
  url: "https://dev.breeze-technologies.de/api/v3/sensors/all/measurements/latest",
  params: {
    api_token: "<YOUR_API_TOKEN>",
    aggregation: "", // optional
    key: "", // optional
  },
};

axios
  .request(config)
  .then((response) => {
    console.log(JSON.stringify(response.data));
  })
  .catch((error) => {
    console.log(error);
  });

Parameters

Name	Description	Type	Data type
api_token	The current user's API token	query	string	Required
aggregation	If the input specifies hour or day aggregation, the function will return the latest available hourly or daily average data, respectively.	query	string
key	A string containing an air quality indicator (e.g. pm25_ug_m3). The list will be filtered to only include data for the specified air quality indicator. If the query parameter is not set, the list will include all air quality indicators.	query	string

Returns

A dictionary with a results property that contains an array of measurements.

{
  "meta": {
    "grades": [
      {
        "value": 1,
        "labels": {
          "de": "sehr gut",
          "en": "excellent"
        }
      },
      {
        "value": 2,
        "labels": {
          "de": "gut",
          "en": "fine"
        }
      },
      {
        "value": 3,
        "labels": {
          "de": "befriedigend",
          "en": "moderate"
        }
      },
      {
        "value": 4,
        "labels": {
          "de": "unbefriedigend",
          "en": "poor"
        }
      },
      {
        "value": 5,
        "labels": {
          "de": "schlecht",
          "en": "very poor"
        }
      },
      {
        "value": 6,
        "labels": {
          "de": "sehr schlecht",
          "en": "severe"
        }
      }
    ],
    "indicators": [
      {
        "key": "aqi",
        "abbreviation": "AQI",
        "labels": {
          "en": "Air Quality Index",
          "de": "Luftqualitätsindex"
        }
      }
    ]
  },
  "results": [
    {
      "Sensor name": "Mungos mungo",
      "Sensor ID": 410,
      "Measurement": {
        "date": "2023-12-29T12:13:35.000Z",
        "values": [
          {
            "key": "aqi",
            "value": null,
            "grade": null
          }
        ]
      }
    },
    {
      "Sensor name": "Dasyurus viverrinus",
      "Sensor ID": 866,
      "Device ID": "ND00273BD",
      "Measurement": {
        "values": []
      }
    },
    {
      "Sensor name": "Picoides pubescens",
      "Sensor ID": 654,
      "Device ID": "ND00029BD",
      "Measurement": {
        "values": []
      }
    },
    {
      "Sensor name": "Bettongia penicillata",
      "Sensor ID": 94,
      "Device ID": "ND00886BD",
      "Measurement": {
        "values": []
      }
    },
    {
      "Sensor name": "Sula dactylatra",
      "Sensor ID": 882,
      "Device ID": "ND00925BD",
      "Measurement": {
        "date": "2023-12-29T12:13:35.000Z",
        "values": [
          {
            "key": "aqi",
            "value": 0,
            "grade": null
          }
        ]
      }
    }
  ]
}