# Umweltbundesamt Air Data

> Read Germany's official air quality data from the German Environment Agency (Umweltbundesamt): about 400 measuring stations run by the federal states, with hourly and daily values for nitrogen dioxide, particulate matter (PM10 and PM2.5), ozone, sulphur dioxide and carbon monoxide since 2016. Get the current air quality index at a station or across the country, the forecast for the next 24 hours, any station's readings over a period, which stations exceeded EU limit values month by month, and yearly statistics. No account or API key required.

App · 15 actions. Web page: https://docs.lodol.com/docs/integrations/umweltbundesamt-air-data

## Actions

### Compare stations

Get one pollutant's value at every station for one hour or one day, in all of Germany or one state, highest first: which stations had the worst air yesterday, or at 8 in the morning.

**Inputs**

- Pollutant (`pollutant`, text, required): The pollutant to compare, such as Particulate matter (PM10).
- Averaging period (`averaging_period`, text, required): How the values are averaged: One hour average gives a value every hour; Daily average and the daily maxima give one value a day.
- Date (`day`, date, required): The day to compare, in German time, from 2016.
- Time (`hour`, time): For hourly averages, the hour to compare: the one starting at this time, in German time, such as 08:00. Daily values ignore it.
- State or network (`network`, text): Only stations run by this federal state's network, or by UBA itself. Leave empty for all of Germany.
- Order (`sort`, text): How to order the stations. Highest value first by default. One of: `highest` (Highest value first), `lowest` (Lowest value first), `station` (By state, then station name). Default: `highest`.

**Outputs**

- `average` (number): The mean of the values in the list, to one decimal place.
- `averaging_period` (text): The averaging period, such as 'One hour average'.
- `count` (number): How many stations have a value.
- `maximum` (number): The highest value in the list.
- `minimum` (number): The lowest value in the list.
- `network` (text): The state or network the list is limited to, if any.
- `pollutant` (text): The pollutant's name, such as 'Nitrogen dioxide'.
- `pollutant_code` (text): The pollutant's code, such as 'NO2'.
- `stations` (list): Each station's value, in the order asked for.
- `unit` (text): The unit of every value, such as 'µg/m³'.

**Example output**

```json
{
  "average": 24.7,
  "averaging_period": "Daily average",
  "count": 3,
  "maximum": 30,
  "minimum": 22,
  "network": "Berlin",
  "pollutant": "Particulate matter (PM10)",
  "pollutant_code": "PM10",
  "stations": [
    {
      "city": "Berlin",
      "date": "2025-07-01",
      "end": "2025-07-02T01:00:00+02:00",
      "end_utc": "2025-07-01T23:00:00Z",
      "network": "Berlin",
      "start": "2025-07-01T01:00:00+02:00",
      "start_utc": "2025-06-30T23:00:00Z",
      "station_code": "DEBE068",
      "station_name": "Berlin Mitte",
      "unit": "\u00b5g/m\u00b3",
      "value": 30
    },
    {
      "city": "Berlin",
      "date": "2025-07-01",
      "end": "2025-07-02T01:00:00+02:00",
      "end_utc": "2025-07-01T23:00:00Z",
      "network": "Berlin",
      "start": "2025-07-01T01:00:00+02:00",
      "start_utc": "2025-06-30T23:00:00Z",
      "station_code": "DEBE065",
      "station_name": "Berlin Frankfurter Allee",
      "unit": "\u00b5g/m\u00b3",
      "value": 22
    },
    {
      "city": "Berlin",
      "date": "2025-07-01",
      "end": "2025-07-02T01:00:00+02:00",
      "end_utc": "2025-07-01T23:00:00Z",
      "network": "Berlin",
      "start": "2025-07-01T01:00:00+02:00",
      "start_utc": "2025-06-30T23:00:00Z",
      "station_code": "DEBE125",
      "station_name": "Berlin Leipziger Stra\u00dfe (MC)",
      "unit": "\u00b5g/m\u00b3",
      "value": 22
    }
  ],
  "unit": "\u00b5g/m\u00b3"
}
```

### Get a station

Get one measuring station by its code, such as DEBE010: its name, address, type, area, coordinates and map link, and which pollutants it measures in which averaging periods, from which day to which. An unknown code is an answer (found is false).

**Inputs**

- Station (`station`, text, required): The measuring station: pick one, or type its code (such as DEBE010), which 'List stations' gives.

**Outputs**

- `active` (true/false): Whether the station still measures.
- `active_from` (text): The date it started measuring, as YYYY-MM-DD.
- `active_to` (text): The date it stopped measuring, as YYYY-MM-DD. Empty while it is active.
- `address` (text): Street, number, postcode and town on one line.
- `air_quality_index_first_date` (text): The first day the station has an air quality index for. Empty when it has none.
- `air_quality_index_last_date` (text): The latest day the station has an air quality index for.
- `area` (text): The kind of area it is in: 'urban', 'suburban' or 'rural'.
- `area_detail` (text): The area in more detail, such as 'urban area' or 'rural regional'.
- `city` (text): The town or city the station is in.
- `code` (text): The station's code, such as 'DEBE010': 'DE', the state's two letters and a number. Every action that takes a station accepts it.
- `found` (true/false): Whether UBA has a station with that code, id or name.
- `latitude` (number): Its latitude in decimal degrees.
- `longitude` (number): Its longitude in decimal degrees.
- `map_url` (text): A link to the station's place on OpenStreetMap.
- `measurements` (list): What the station measures and over which dates, one entry per pollutant and averaging period.
- `name` (text): The station's name, such as 'Berlin Wedding'.
- `network` (text): The measuring network that runs the station: a federal state's, such as 'Bavaria', or 'UBA' for the agency's own background stations.
- `network_code` (text): The network's code, such as 'BE' for Berlin.
- `station_type` (text): What the station is placed to measure: 'background', 'traffic' (next to a busy road) or 'industry'.
- `street` (text): The street it stands on.
- `street_number` (text): The house number, when it has one.
- `zip_code` (text): Its postcode.

**Example output**

```json
{
  "active": true,
  "active_from": "1984-11-01",
  "active_to": null,
  "address": "Amrumer Str./Limburger Str., 13353 Berlin",
  "air_quality_index_first_date": "2016-01-01",
  "air_quality_index_last_date": "2026-10-23",
  "area": "urban",
  "area_detail": "urban area",
  "city": "Berlin",
  "code": "DEBE010",
  "found": true,
  "latitude": 52.543,
  "longitude": 13.3493,
  "map_url": "https://www.openstreetmap.org/?mlat=52.543&mlon=13.3493#map=16/52.543/13.3493",
  "measurements": [
    {
      "averaging_period": "Daily average",
      "averaging_period_code": "1TMW",
      "first_date": "2016-01-01",
      "last_date": "2026-10-22",
      "pollutant": "Particulate matter (PM10)",
      "pollutant_code": "PM10"
    },
    {
      "averaging_period": "One hour average",
      "averaging_period_code": "1SMW",
      "first_date": "2016-01-01",
      "last_date": "2026-10-23",
      "pollutant": "Particulate matter (PM10)",
      "pollutant_code": "PM10"
    },
    {
      "averaging_period": "Maximum one hour average",
      "averaging_period_code": "1SMW_MAX",
      "first_date": "2016-01-01",
      "last_date": "2026-10-22",
      "pollutant": "Particulate matter (PM10)",
      "pollutant_code": "PM10"
    }
  ],
  "name": "Berlin Wedding",
  "network": "Berlin",
  "network_code": "BE",
  "station_type": "background",
  "street": "Amrumer Str./Limburger Str.",
  "street_number": null,
  "zip_code": "13353"
}
```

### Get air quality forecast

Get UBA's hourly air quality forecast for a station for the next 24 hours: each pollutant's expected value and class, and the worst class each hour.

**Inputs**

- Station (`station`, text, required): The measuring station: pick one, or type its code (such as DEBE010), which 'List stations' gives.

**Outputs**

- `city` (text): The town or city the station is in.
- `count` (number): How many forecast hours there are.
- `created` (text): When UBA made the forecast, as an ISO 8601 date and time in German local time, with its UTC offset (+01:00 in winter, +02:00 in summer).
- `hours` (list): Each forecast hour, soonest first.
- `network` (text): The measuring network that runs the station: a federal state's, such as 'Bavaria', or 'UBA' for the agency's own background stations.
- `station_code` (text): The station's code, such as 'DEBE010'.
- `station_name` (text): The station's name, such as 'Berlin Wedding'.
- `worst_index` (number): The worst index class in the list, from 0 (very good) to 4 (very poor).
- `worst_index_label` (text): The worst class in words, such as 'moderate'.

**Example output**

```json
{
  "city": "Berlin",
  "count": 2,
  "created": "2026-10-23T22:25:00+02:00",
  "hours": [
    {
      "end": "2026-10-23T22:00:00+02:00",
      "end_utc": "2026-10-23T20:00:00Z",
      "highest_index": 1,
      "highest_index_label": "good",
      "pollutants": [
        {
          "code": "PM10",
          "index": 0,
          "index_label": "very good",
          "name": "Particulate matter (PM10)",
          "unit": "\u00b5g/m\u00b3",
          "value": 4
        },
        {
          "code": "O3",
          "index": 1,
          "index_label": "good",
          "name": "Ozone (O3)",
          "unit": "\u00b5g/m\u00b3",
          "value": 68
        }
      ],
      "start": "2026-10-23T21:00:00+02:00",
      "start_utc": "2026-10-23T19:00:00Z"
    },
    {
      "end": "2026-10-23T23:00:00+02:00",
      "end_utc": "2026-10-23T21:00:00Z",
      "highest_index": 1,
      "highest_index_label": "good",
      "pollutants": [
        {
          "code": "PM10",
          "index": 0,
          "index_label": "very good",
          "name": "Particulate matter (PM10)",
          "unit": "\u00b5g/m\u00b3",
          "value": 5
        },
        {
          "code": "O3",
          "index": 1,
          "index_label": "good",
          "name": "Ozone (O3)",
          "unit": "\u00b5g/m\u00b3",
          "value": 66
        }
      ],
      "start": "2026-10-23T22:00:00+02:00",
      "start_utc": "2026-10-23T20:00:00Z"
    }
  ],
  "network": "Berlin",
  "station_code": "DEBE010",
  "station_name": "Berlin Wedding",
  "worst_index": 1,
  "worst_index_label": "good"
}
```

### Get air quality history

Get a station's hourly air quality index over a period, up to 31 days: each hour's class from very good to very poor, and each pollutant's value and class. Times are German local time, and each value also comes with its time in UTC.

**Inputs**

- Station (`station`, text, required): The measuring station: pick one, or type its code (such as DEBE010), which 'List stations' gives.
- From date (`date_from`, date, required): The first day to read, in German time. Data starts on 1 January 2016.
- To date (`date_to`, date): The last day to read. Leave empty to read 'From date' alone.
- From time (`time_from`, time): Start at this hour of 'From date', in German time, such as 08:00. Leave empty to start at midnight. Daily values ignore it.
- To time (`time_to`, time): Stop at this hour of 'To date', in German time: 12:00 ends with the hour from 11:00 to 12:00. Leave empty to read to the end of the day. Daily values ignore it.

**Outputs**

- `city` (text): The town or city the station is in.
- `count` (number): How many hours have an index.
- `from` (text): The start of the period asked for, as an ISO 8601 date and time in German local time, with its UTC offset (+01:00 in winter, +02:00 in summer).
- `hours` (list): Each hour's index, oldest first.
- `network` (text): The measuring network that runs the station: a federal state's, such as 'Bavaria', or 'UBA' for the agency's own background stations.
- `station_code` (text): The station's code, such as 'DEBE010'.
- `station_name` (text): The station's name, such as 'Berlin Wedding'.
- `to` (text): The end of the period asked for, as an ISO 8601 date and time in German local time, with its UTC offset (+01:00 in winter, +02:00 in summer).
- `worst_index` (number): The worst index class in the list, from 0 (very good) to 4 (very poor).
- `worst_index_label` (text): The worst class in words, such as 'moderate'.

**Example output**

```json
{
  "city": "Berlin",
  "count": 2,
  "from": "2025-07-01T08:00:00+02:00",
  "hours": [
    {
      "end": "2025-07-01T09:00:00+02:00",
      "end_utc": "2025-07-01T07:00:00Z",
      "incomplete": true,
      "index": 1,
      "index_label": "good",
      "pollutants": [
        {
          "code": "PM10",
          "index": 1,
          "index_label": "good",
          "name": "Particulate matter (PM10)",
          "unit": "\u00b5g/m\u00b3",
          "value": 26
        },
        {
          "code": "O3",
          "index": 1,
          "index_label": "good",
          "name": "Ozone (O3)",
          "unit": "\u00b5g/m\u00b3",
          "value": 53
        }
      ],
      "start": "2025-07-01T08:00:00+02:00",
      "start_utc": "2025-07-01T06:00:00Z"
    },
    {
      "end": "2025-07-01T10:00:00+02:00",
      "end_utc": "2025-07-01T08:00:00Z",
      "incomplete": true,
      "index": 2,
      "index_label": "moderate",
      "pollutants": [
        {
          "code": "PM10",
          "index": 1,
          "index_label": "good",
          "name": "Particulate matter (PM10)",
          "unit": "\u00b5g/m\u00b3",
          "value": 22
        },
        {
          "code": "O3",
          "index": 2,
          "index_label": "moderate",
          "name": "Ozone (O3)",
          "unit": "\u00b5g/m\u00b3",
          "value": 77
        }
      ],
      "start": "2025-07-01T09:00:00+02:00",
      "start_utc": "2025-07-01T07:00:00Z"
    }
  ],
  "network": "Berlin",
  "station_code": "DEBE010",
  "station_name": "Berlin Wedding",
  "to": "2025-07-01T10:00:00+02:00",
  "worst_index": 2,
  "worst_index_label": "moderate"
}
```

### Get annual statistics

Get each station's figures for one pollutant in a year, as UBA checks them against EU limit values: the annual mean and the number of hours or days above each limit. A year appears once its data is final, usually by the middle of the next year.

**Inputs**

- Pollutant (`pollutant`, text, required): The pollutant, such as Nitrogen dioxide (NO2) or Benzene (C6H6).
- Year (`year`, number, required): The year of the statistics, from 2000. At least 2000.
- State or network (`network`, text): Only stations run by this federal state's network, or by UBA itself. Leave empty for all of Germany.
- Station (`station`, text): Only this station: pick one or type its code, such as DEBE010. Leave empty for every station.

**Outputs**

- `columns` (list): The figures UBA gives for this pollutant, such as 'Annual mean value in µg/m³', in the order of each station's values.
- `count` (number): How many stations are listed.
- `pollutant` (text): The pollutant's name, such as 'Nitrogen dioxide'.
- `pollutant_code` (text): The pollutant's code, such as 'NO2'.
- `stations` (list): Each station's figures, by state and name.
- `unit` (text): The pollutant's usual unit; each figure's label names its own.
- `year` (number): The year of the statistics.

**Example output**

```json
{
  "columns": [
    "Number of hourly mean values above 240 \u00b5g/m\u00b3",
    "Number of hourly mean values above 180 \u00b5g/m\u00b3"
  ],
  "count": 2,
  "pollutant": "Ozone (O3)",
  "pollutant_code": "O3",
  "stations": [
    {
      "annual_mean": null,
      "city": "Bremen",
      "network": "Bremen",
      "station_code": "DEHB013",
      "station_name": "Bremen-Hasenb\u00fcren",
      "values": [
        {
          "label": "Number of hourly mean values above 240 \u00b5g/m\u00b3",
          "value": 0
        },
        {
          "label": "Number of hourly mean values above 180 \u00b5g/m\u00b3",
          "value": 0
        }
      ]
    },
    {
      "annual_mean": null,
      "city": "Bremen",
      "network": "Bremen",
      "station_code": "DEHB001",
      "station_name": "Bremen-Mitte",
      "values": [
        {
          "label": "Number of hourly mean values above 240 \u00b5g/m\u00b3",
          "value": 0
        },
        {
          "label": "Number of hourly mean values above 180 \u00b5g/m\u00b3",
          "value": 0
        }
      ]
    }
  ],
  "unit": "\u00b5g/m\u00b3",
  "year": 2024
}
```

### Get current air quality

Get a station's latest hourly air quality index, from very good to very poor, with each pollutant's value and class. Found is false for a station that no longer measures.

**Inputs**

- Station (`station`, text, required): The measuring station: pick one, or type its code (such as DEBE010), which 'List stations' gives.

**Outputs**

- `city` (text): The town or city the station is in.
- `end` (text): When the reading's period ends, as an ISO 8601 date and time in German local time, with its UTC offset (+01:00 in winter, +02:00 in summer).
- `end_utc` (text): When the reading's period ends, as an ISO 8601 date and time in UTC.
- `found` (true/false): Whether the station has a recent air quality index. A station that has stopped measuring has none.
- `incomplete` (true/false): True when not every pollutant the index uses was measured that hour, so the index rests on fewer of them.
- `index` (number): The hour's air quality index, from 0 (very good) to 4 (very poor): the worst class among its pollutants.
- `index_label` (text): The index in words: very good, good, moderate, poor or very poor.
- `network` (text): The measuring network that runs the station: a federal state's, such as 'Bavaria', or 'UBA' for the agency's own background stations.
- `pollutants` (list): Each pollutant measured that hour, with its value and class.
- `start` (text): When the reading's period starts, as an ISO 8601 date and time in German local time, with its UTC offset (+01:00 in winter, +02:00 in summer).
- `start_utc` (text): When the reading's period starts, as an ISO 8601 date and time in UTC.
- `station_code` (text): The station's code, such as 'DEBE010'.
- `station_name` (text): The station's name, such as 'Berlin Wedding'.

**Example output**

```json
{
  "city": "Berlin",
  "end": "2026-10-23T21:00:00+02:00",
  "end_utc": "2026-10-23T19:00:00Z",
  "found": true,
  "incomplete": true,
  "index": 1,
  "index_label": "good",
  "network": "Berlin",
  "pollutants": [
    {
      "code": "PM10",
      "index": 0,
      "index_label": "very good",
      "name": "Particulate matter (PM10)",
      "unit": "\u00b5g/m\u00b3",
      "value": 9
    },
    {
      "code": "O3",
      "index": 1,
      "index_label": "good",
      "name": "Ozone (O3)",
      "unit": "\u00b5g/m\u00b3",
      "value": 43
    },
    {
      "code": "NO2",
      "index": 1,
      "index_label": "good",
      "name": "Nitrogen dioxide (NO2)",
      "unit": "\u00b5g/m\u00b3",
      "value": 15
    },
    {
      "code": "PM2",
      "index": 0,
      "index_label": "very good",
      "name": "Particulate matter (PM2.5)",
      "unit": "\u00b5g/m\u00b3",
      "value": 5
    }
  ],
  "start": "2026-10-23T20:00:00+02:00",
  "start_utc": "2026-10-23T18:00:00Z",
  "station_code": "DEBE010",
  "station_name": "Berlin Wedding"
}
```

### Get current air quality at every station

Get the latest hourly air quality index at every station in Germany or in one state, worst first, optionally only those at or worse than a class such as moderate.

**Inputs**

- State or network (`network`, text): Only stations run by this federal state's network, or by UBA itself. Leave empty for all of Germany.
- Show stations (`minimum_index`, text): Only stations whose index is at least this bad. Every station by default. One of: `0` (Every station), `1` (Good or worse), `2` (Moderate or worse), `3` (Poor or worse), `4` (Very poor only). Default: `0`.

**Outputs**

- `count` (number): How many stations are listed.
- `network` (text): The state or network the list is limited to, if any.
- `stations` (list): Each station's latest hour, worst index first.
- `worst_index` (number): The worst index class in the list, from 0 (very good) to 4 (very poor).
- `worst_index_label` (text): The worst class in words, such as 'moderate'.

**Example output**

```json
{
  "count": 2,
  "network": "Berlin",
  "stations": [
    {
      "city": "Berlin",
      "end": "2026-10-23T21:00:00+02:00",
      "end_utc": "2026-10-23T19:00:00Z",
      "incomplete": true,
      "index": 1,
      "index_label": "good",
      "network": "Berlin",
      "pollutants": [
        {
          "code": "PM10",
          "index": 1,
          "index_label": "good",
          "name": "Particulate matter (PM10)",
          "unit": "\u00b5g/m\u00b3",
          "value": 10
        },
        {
          "code": "O3",
          "index": 1,
          "index_label": "good",
          "name": "Ozone (O3)",
          "unit": "\u00b5g/m\u00b3",
          "value": 30
        }
      ],
      "start": "2026-10-23T20:00:00+02:00",
      "start_utc": "2026-10-23T18:00:00Z",
      "station_code": "DEBE051",
      "station_name": "Berlin Buch"
    },
    {
      "city": "Berlin",
      "end": "2026-10-23T21:00:00+02:00",
      "end_utc": "2026-10-23T19:00:00Z",
      "incomplete": true,
      "index": 1,
      "index_label": "good",
      "network": "Berlin",
      "pollutants": [
        {
          "code": "PM10",
          "index": 1,
          "index_label": "good",
          "name": "Particulate matter (PM10)",
          "unit": "\u00b5g/m\u00b3",
          "value": 15
        },
        {
          "code": "O3",
          "index": 1,
          "index_label": "good",
          "name": "Ozone (O3)",
          "unit": "\u00b5g/m\u00b3",
          "value": 38
        }
      ],
      "start": "2026-10-23T20:00:00+02:00",
      "start_utc": "2026-10-23T18:00:00Z",
      "station_code": "DEBE065",
      "station_name": "Berlin Frankfurter Allee"
    }
  ],
  "worst_index": 1,
  "worst_index_label": "good"
}
```

### Get exceedances

Get how often each station exceeded the EU limit or target value for PM10, nitrogen dioxide or ozone in a year, month by month, most first. The current year counts so far.

**Inputs**

- Pollutant (`pollutant`, text, required): PM10 counts days with a daily mean above 50 µg/m³, nitrogen dioxide hours above 200 µg/m³, ozone days with an eight hour mean above 120 µg/m³. One of: `PM10` (Particulate matter (PM10)), `NO2` (Nitrogen dioxide (NO2)), `O3` (Ozone (O3)).
- Year (`year`, number, required): The year of the exceedance table, from 2016. At least 2016.
- State or network (`network`, text): Only stations run by this federal state's network, or by UBA itself. Leave empty for all of Germany.
- Station (`station`, text): Only this station: pick one or type its code, such as DEBE010. Leave empty for every station.

**Outputs**

- `count` (number): How many stations are listed.
- `counted` (text): What is counted, such as 'Number of daily mean values above 50 µg/m³'.
- `pollutant` (text): The pollutant's name, such as 'Nitrogen dioxide'.
- `pollutant_code` (text): The pollutant's code, such as 'NO2'.
- `stations` (list): Each station's count, most exceedances first.
- `stations_with_exceedances` (number): How many of them exceeded the value at least once.
- `year` (number): The year of the table.

**Example output**

```json
{
  "count": 2,
  "counted": "Number of daily mean values above 50 \u00b5g/m\u00b3",
  "pollutant": "Particulate matter (PM10)",
  "pollutant_code": "PM10",
  "stations": [
    {
      "april": 2,
      "august": 0,
      "city": "Berlin",
      "december": 0,
      "february": 0,
      "first_day": "2024-01-01",
      "january": 2,
      "july": 0,
      "june": 0,
      "last_day": "2024-12-31",
      "march": 3,
      "may": 0,
      "network": "Berlin",
      "november": 0,
      "october": 0,
      "september": 3,
      "station_code": "DEBE065",
      "station_name": "Berlin Frankfurter Allee",
      "total": 10
    },
    {
      "april": 1,
      "august": 0,
      "city": "Berlin",
      "december": 0,
      "february": 0,
      "first_day": "2024-01-01",
      "january": 1,
      "july": 0,
      "june": 0,
      "last_day": "2024-12-31",
      "march": 4,
      "may": 0,
      "network": "Berlin",
      "november": 0,
      "october": 0,
      "september": 4,
      "station_code": "DEBE127",
      "station_name": "Berlin Silbersteinstra\u00dfe 5",
      "total": 10
    }
  ],
  "stations_with_exceedances": 2,
  "year": 2024
}
```

### Get measurements

Get a station's values for one pollutant over a period, hourly or daily, with the lowest, highest and mean value. Up to 31 days of hourly values or a year of daily ones. Times are German local time, and each value also comes with its time in UTC.

**Inputs**

- Station (`station`, text, required): The measuring station: pick one, or type its code (such as DEBE010), which 'List stations' gives.
- Pollutant (`pollutant`, text, required): The pollutant to read, such as Nitrogen dioxide (NO2) or Particulate matter (PM10). Not every station measures every pollutant: 'Get a station' lists what it measures.
- Averaging period (`averaging_period`, text, required): How the values are averaged: One hour average gives a value every hour; Daily average and the daily maxima give one value a day.
- From date (`date_from`, date, required): The first day to read, in German time. Data starts on 1 January 2016.
- To date (`date_to`, date): The last day to read. Leave empty to read 'From date' alone.
- From time (`time_from`, time): Start at this hour of 'From date', in German time, such as 08:00. Leave empty to start at midnight. Daily values ignore it.
- To time (`time_to`, time): Stop at this hour of 'To date', in German time: 12:00 ends with the hour from 11:00 to 12:00. Leave empty to read to the end of the day. Daily values ignore it.

**Outputs**

- `average` (number): The mean of the values in the list, to one decimal place.
- `averaging_period` (text): The averaging period, such as 'One hour average'.
- `city` (text): The town or city the station is in.
- `count` (number): How many values the period holds.
- `from` (text): The start of the period asked for, as an ISO 8601 date and time in German local time, with its UTC offset (+01:00 in winter, +02:00 in summer).
- `maximum` (number): The highest value in the list.
- `measurements` (list): Each value, oldest first.
- `minimum` (number): The lowest value in the list.
- `network` (text): The measuring network that runs the station: a federal state's, such as 'Bavaria', or 'UBA' for the agency's own background stations.
- `pollutant` (text): The pollutant's name, such as 'Nitrogen dioxide'.
- `pollutant_code` (text): The pollutant's code, such as 'NO2'.
- `station_code` (text): The station's code, such as 'DEBE010'.
- `station_name` (text): The station's name, such as 'Berlin Wedding'.
- `to` (text): The end of the period asked for, as an ISO 8601 date and time in German local time, with its UTC offset (+01:00 in winter, +02:00 in summer).
- `unit` (text): The unit of every value, such as 'µg/m³'.

**Example output**

```json
{
  "average": 18.0,
  "averaging_period": "One hour average",
  "city": "Berlin",
  "count": 4,
  "from": "2025-07-01T08:00:00+02:00",
  "maximum": 27,
  "measurements": [
    {
      "date": "2025-07-01",
      "end": "2025-07-01T09:00:00+02:00",
      "end_utc": "2025-07-01T07:00:00Z",
      "start": "2025-07-01T08:00:00+02:00",
      "start_utc": "2025-07-01T06:00:00Z",
      "unit": "\u00b5g/m\u00b3",
      "value": 27
    },
    {
      "date": "2025-07-01",
      "end": "2025-07-01T10:00:00+02:00",
      "end_utc": "2025-07-01T08:00:00Z",
      "start": "2025-07-01T09:00:00+02:00",
      "start_utc": "2025-07-01T07:00:00Z",
      "unit": "\u00b5g/m\u00b3",
      "value": 17
    },
    {
      "date": "2025-07-01",
      "end": "2025-07-01T11:00:00+02:00",
      "end_utc": "2025-07-01T09:00:00Z",
      "start": "2025-07-01T10:00:00+02:00",
      "start_utc": "2025-07-01T08:00:00Z",
      "unit": "\u00b5g/m\u00b3",
      "value": 15
    },
    {
      "date": "2025-07-01",
      "end": "2025-07-01T12:00:00+02:00",
      "end_utc": "2025-07-01T10:00:00Z",
      "start": "2025-07-01T11:00:00+02:00",
      "start_utc": "2025-07-01T09:00:00Z",
      "unit": "\u00b5g/m\u00b3",
      "value": 13
    }
  ],
  "minimum": 13,
  "network": "Berlin",
  "pollutant": "Nitrogen dioxide (NO2)",
  "pollutant_code": "NO2",
  "station_code": "DEBE010",
  "station_name": "Berlin Wedding",
  "to": "2025-07-01T12:00:00+02:00",
  "unit": "\u00b5g/m\u00b3"
}
```

### Get the latest measurement

Get a station's most recent value for one pollutant, with when it was measured. Looks back 7 days; found is false when there is no value in that time.

**Inputs**

- Station (`station`, text, required): The measuring station: pick one, or type its code (such as DEBE010), which 'List stations' gives.
- Pollutant (`pollutant`, text, required): The pollutant to read, such as Nitrogen dioxide (NO2) or Particulate matter (PM10). Not every station measures every pollutant: 'Get a station' lists what it measures.
- Averaging period (`averaging_period`, text): How the values are averaged: One hour average gives a value every hour; Daily average and the daily maxima give one value a day. One hour average by default. Default: `1SMW`.

**Outputs**

- `averaging_period` (text): The averaging period, such as 'One hour average'.
- `city` (text): The town or city the station is in.
- `date` (text): The day of the reading, as YYYY-MM-DD. For a daily value, the day it describes.
- `end` (text): When the reading's period ends, as an ISO 8601 date and time in German local time, with its UTC offset (+01:00 in winter, +02:00 in summer).
- `end_utc` (text): When the reading's period ends, as an ISO 8601 date and time in UTC.
- `found` (true/false): Whether the station has a value for this pollutant and averaging period in the last 7 days.
- `network` (text): The measuring network that runs the station: a federal state's, such as 'Bavaria', or 'UBA' for the agency's own background stations.
- `pollutant` (text): The pollutant's name, such as 'Nitrogen dioxide'.
- `pollutant_code` (text): The pollutant's code, such as 'NO2'.
- `start` (text): When the reading's period starts, as an ISO 8601 date and time in German local time, with its UTC offset (+01:00 in winter, +02:00 in summer).
- `start_utc` (text): When the reading's period starts, as an ISO 8601 date and time in UTC.
- `station_code` (text): The station's code, such as 'DEBE010'.
- `station_name` (text): The station's name, such as 'Berlin Wedding'.
- `unit` (text): The unit of every value, such as 'µg/m³'.
- `value` (number): The latest value, as a number.

**Example output**

```json
{
  "averaging_period": "One hour average",
  "city": "Berlin",
  "date": "2026-10-23",
  "end": "2026-10-23T21:00:00+02:00",
  "end_utc": "2026-10-23T19:00:00Z",
  "found": true,
  "network": "Berlin",
  "pollutant": "Ozone (O3)",
  "pollutant_code": "O3",
  "start": "2026-10-23T20:00:00+02:00",
  "start_utc": "2026-10-23T18:00:00Z",
  "station_code": "DEBE010",
  "station_name": "Berlin Wedding",
  "unit": "\u00b5g/m\u00b3",
  "value": 43
}
```

### List air quality index bands

List the hourly values that put each pollutant in each class of UBA's air quality index, from very good to very poor, to read a value against.

**Inputs**: None.

**Outputs**

- `count` (number): How many pollutants have index bands.
- `pollutants` (list): Each pollutant the air quality index uses, with the hourly values that make each class.

**Example output**

```json
{
  "count": 2,
  "pollutants": [
    {
      "averaging_period": "One hour average",
      "bands": [
        {
          "from": 0,
          "index": 0,
          "label": "very good",
          "to": 9
        },
        {
          "from": 10,
          "index": 1,
          "label": "good",
          "to": 27
        }
      ],
      "pollutant": "Particulate matter (PM10)",
      "pollutant_code": "PM10",
      "unit": "\u00b5g/m\u00b3"
    },
    {
      "averaging_period": "One hour average",
      "bands": [
        {
          "from": 0,
          "index": 0,
          "label": "very good",
          "to": 24
        },
        {
          "from": 25,
          "index": 1,
          "label": "good",
          "to": 72
        }
      ],
      "pollutant": "Ozone (O3)",
      "pollutant_code": "O3",
      "unit": "\u00b5g/m\u00b3"
    }
  ]
}
```

### List averaging periods

List the averaging periods UBA gives values in, such as the one hour average, the daily average and the daily maxima, with how many hours each averages and how many values a day it gives.

**Inputs**: None.

**Outputs**

- `averaging_periods` (list): Every averaging period a measurement can be asked for in.
- `count` (number): How many averaging periods UBA lists.

**Example output**

```json
{
  "averaging_periods": [
    {
      "code": "1TMW",
      "daily_maximum": false,
      "hours": 24,
      "id": "1",
      "name": "Daily average",
      "values_per_day": 1
    },
    {
      "code": "1SMW",
      "daily_maximum": false,
      "hours": 1,
      "id": "2",
      "name": "One hour average",
      "values_per_day": 24
    },
    {
      "code": "1SMW_MAX",
      "daily_maximum": true,
      "hours": 1,
      "id": "3",
      "name": "Maximum one hour average",
      "values_per_day": 1
    },
    {
      "code": "8SMW",
      "daily_maximum": false,
      "hours": 8,
      "id": "4",
      "name": "Eight hour average",
      "values_per_day": 24
    },
    {
      "code": "8SMW_MAX",
      "daily_maximum": true,
      "hours": 8,
      "id": "5",
      "name": "Maximum eight hour average",
      "values_per_day": 1
    },
    {
      "code": "1TMWGL",
      "daily_maximum": false,
      "hours": 1,
      "id": "6",
      "name": "Daily average (hourly floating)",
      "values_per_day": 24
    }
  ],
  "count": 6
}
```

### List measuring networks

List the measuring networks behind the stations: one for each of Germany's 16 federal states, and UBA's own.

**Inputs**: None.

**Outputs**

- `count` (number): How many networks UBA lists.
- `networks` (list): Every measuring network: one per federal state, and UBA's own.

**Example output**

```json
{
  "count": 3,
  "networks": [
    {
      "code": "BW",
      "id": "1",
      "name": "Baden-W\u00fcrttemberg"
    },
    {
      "code": "BY",
      "id": "2",
      "name": "Bavaria"
    },
    {
      "code": "BE",
      "id": "3",
      "name": "Berlin"
    }
  ]
}
```

### List pollutants

List every pollutant UBA publishes data for, such as nitrogen dioxide, particulate matter (PM10 and PM2.5), ozone and benzene, with its code, chemical symbol and unit.

**Inputs**: None.

**Outputs**

- `count` (number): How many pollutants UBA lists.
- `pollutants` (list): Every pollutant UBA publishes data for.

**Example output**

```json
{
  "count": 3,
  "pollutants": [
    {
      "code": "PM10",
      "id": "1",
      "name": "Particulate matter (PM10)",
      "symbol": "PM\u2081\u2080",
      "unit": "\u00b5g/m\u00b3"
    },
    {
      "code": "CO",
      "id": "2",
      "name": "Carbon monoxide (CO)",
      "symbol": "CO",
      "unit": "mg/m\u00b3"
    },
    {
      "code": "O3",
      "id": "3",
      "name": "Ozone (O3)",
      "symbol": "O\u2083",
      "unit": "\u00b5g/m\u00b3"
    }
  ]
}
```

### List stations

Find air quality measuring stations in Germany by state, type (background, traffic or industry), area (urban, suburban or rural), the data they have and words in their name, town or postcode. Each comes with its code, address, coordinates and a map link.

**Inputs**

- State or network (`network`, text): Only stations run by this federal state's network, or by UBA itself. Leave empty for all of Germany.
- Station type (`station_type`, text): Only stations placed to measure this. Any type by default. One of: `any` (Any type), `background` (Background (away from direct sources)), `traffic` (Traffic (next to a busy road)), `industry` (Industry (near industrial sites)). Default: `any`.
- Area (`area`, text): Only stations in this kind of area. Any area by default. One of: `any` (Any area), `urban`, `suburban`, `rural`. Default: `any`.
- Stations with (`data`, text): Which stations to look at: those with measurements since 2016 by default, or those in the air quality index, the exceedance tables or the annual statistics, or every station UBA has ever listed. One of: `measure` (Stations with measurements (since 2016)), `airquality` (Stations with an air quality index), `transgression` (Stations in the exceedance tables), `annualbalance` (Stations in the annual statistics (since 2000)), `all` (Every station UBA lists, past and present). Default: `measure`.
- Active stations only (`active_only`, true/false): Leave out stations that have stopped measuring. Default: `true`.
- Search (`search`, text): Words that must all appear in the station's name, code, town, street or postcode.
- How many to return (`limit`, number): The most stations to list, up to 1000. From 1 to 1000. Default: `100`.

**Outputs**

- `count` (number): How many stations are listed here.
- `stations` (list): The matching stations, by state and name.
- `total` (number): How many stations match, before 'How many to return'.

**Example output**

```json
{
  "count": 2,
  "stations": [
    {
      "active": true,
      "active_from": "2017-07-24",
      "active_to": null,
      "address": "Hobrechtsfelder Chaussee 110-113, 13125 Berlin",
      "area": "suburban",
      "area_detail": "suburban area",
      "city": "Berlin",
      "code": "DEBE051",
      "latitude": 52.6442,
      "longitude": 13.4831,
      "map_url": "https://www.openstreetmap.org/?mlat=52.6442&mlon=13.4831#map=16/52.6442/13.4831",
      "name": "Berlin Buch",
      "network": "Berlin",
      "network_code": "BE",
      "station_type": "background",
      "street": "Hobrechtsfelder Chaussee",
      "street_number": "110-113",
      "zip_code": "13125"
    },
    {
      "active": true,
      "active_from": "1993-09-01",
      "active_to": null,
      "address": "Frankfurter Allee 86b, 10247 Berlin",
      "area": "urban",
      "area_detail": "urban area",
      "city": "Berlin",
      "code": "DEBE065",
      "latitude": 52.5141,
      "longitude": 13.4699,
      "map_url": "https://www.openstreetmap.org/?mlat=52.5141&mlon=13.4699#map=16/52.5141/13.4699",
      "name": "Berlin Frankfurter Allee",
      "network": "Berlin",
      "network_code": "BE",
      "station_type": "traffic",
      "street": "Frankfurter Allee",
      "street_number": "86b",
      "zip_code": "10247"
    }
  ],
  "total": 15
}
```
