Reference · built on requestCommons signalAir, water & environment

Umweltbundesamt Air Data API

Hourly German station measurements and the air quality index from the Umweltbundesamt Air Data API v4, as JSON.

Request accessPricing ↗

About

The Umweltbundesamt, Germany's federal environment agency, publishes the Air Data API for measurements collected by the monitoring networks of the sixteen federal states and its own network. Version 4 answers GET requests at luftdaten.umweltbundesamt.de/api/air-data/v4 with JSON, in English by default and in German with lang=de. Data are available from 1 January 2016. Twelve components are listed, among them PM10, PM2.5, NO2, O3, SO2, CO, and benzene.

An operator on Fibric queries the stations nearest each site for hourly values and the air quality index, then decides whether outdoor air should be brought in.

This is a reference listing. It documents what Fibric would read from Umweltbundesamt Air Data API and what it could propose, based on the publisher's published interfaces. Fibric builds it under a managed deployment when you request it; selecting it here installs nothing.

Inputs

  • Hourly pollutant concentrations plus the air quality index per station through /airquality/json
  • Measures by station, component, and scope through /measures/json, bounded by date_from, date_to, time_from, and time_to
  • Air quality forecasts for today and tomorrow through /airqualityforecast/json
  • Stations, components, scopes, networks, and station types through /stations/json, /components/json, /scopes/json, and /networks/json
  • Limit and target value evaluations through /annualbalances/json and monthly exceedances through /transgressions/json
  • Available date ranges per station and component through /measures/limits and /airquality/limits
  • Combined metadata for a query type through /meta/json with use=airquality or use=measure

Proposed actions

Read-only. This feed informs operators; it changes nothing.

Proposed actions are target capabilities. Every action runs propose-first and needs a validated deployment and the appropriate permissions.

What you can build

  • Gate outside-air intake on the local index

    Read the air quality index at the nearest station each hour and propose a reduced outdoor-air fraction when it worsens. You approve; the receipt names the station and hour.

    With Indoor Air, Economizer Check

  • Time filter changes to particulate load

    Sum hourly PM10 at the station nearest each building and bring the filter change forward when cumulative exposure runs ahead of plan.

    With Filter Change

  • Give staff a day's notice on ozone

    Use the today-and-tomorrow forecast to warn sites where the index is expected to reach a level you set, with the station cited.

    With Severe Weather Notice

Requirements

  • Station IDs or codes (for example DEBB021) from /stations/json
  • Component and scope IDs; PM10 is component 1, NO2 is 5, PM2.5 is 9, and the one-hour average is scope 2
  • The source reference "Umweltbundesamt mit Daten der Messnetze der Länder und des Bundes" wherever you show the data
Authentication
None. The v4 specification declares no security scheme; requests are plain HTTPS GET.

Limits

  • Current-year data are not finally audited; final data are published in June of the following year
  • Series can have gaps from transmission problems, and UBA does not guarantee completeness
  • Not every pollutant is measured at every station; invalid combinations return JSON without data
  • Records carry the end of each measurement period; daily values are stamped at 12:00

Access and pricing

Reference listing. Public feed access is separate from Fibric integration. If you request this feed, your quote covers the build, usage, and support.

Request Umweltbundesamt Air Data API ↗

Questions and answers

Which pollutants and time bases does the API cover?
Twelve components: PM10, CO, O3, SO2, NO2, PM2.5, benzene, and lead, benzo(a)pyrene, arsenic, cadmium, and nickel in PM10. Six scopes: daily average, one-hour average, maximum one-hour, eight-hour average, maximum eight-hour, and hourly-floating daily average.
How far back does the data go, and is it final?
Data are available from 1 January 2016. Current-year values are provisional until the audited data are released in June of the following year, and gaps from transmission problems can occur.
What licence and attribution apply?
Datenlizenz Deutschland Namensnennung 2.0 (DL-DE/BY-2.0). UBA asks for the source reference "Umweltbundesamt mit Daten der Messnetze der Länder und des Bundes".
Ask about Umweltbundesamt Air Data API

Ask about the capabilities and requirements in this listing.

For project-specific requirements, contact Fibric.

This Commons signal listing is developed, published, and supported by Fibric. It reads public data published by Umweltbundesamt (luftdaten.umweltbundesamt.de). Upstream agencies and projects are the property of their respective owners, who are not affiliated with Fibric and do not sponsor or endorse this listing. Trademark policy