bund.dev Measurements API

The measurements API from bund.dev — 2 operation(s) for measurements.

GitHub OpenAPI

Operations 2

GET /measures/json Get all measurements #
GET /measures/limits Get measurement date limits #

Documentation

Specifications

Schemas & Data

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/bund-dev:bund-dev-measurements-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

bund-dev-measurements-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Bund Dev Measurements API
  version: 2.0.1
  contact:
    email: immission@uba.de
    name: API Support
  description: 'Operations tagged measurements across 2 of this provider''s published API definitions: luftqualitaet.yaml, bund-dev-luftqualitaet-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://www.umweltbundesamt.de/api/air_data/v2
  description: Public API
tags:
- name: Measurements
  x-displayName: Measurements
paths:
  /measures/json:
    get:
      description: This entry point returns measures for the provided parameters.
      parameters:
      - $ref: '#/components/parameters/dateFromReq'
      - $ref: '#/components/parameters/timeFromReq'
      - $ref: '#/components/parameters/dateToReq'
      - $ref: '#/components/parameters/timeToReq'
      - $ref: '#/components/parameters/station'
      - $ref: '#/components/parameters/component'
      - $ref: '#/components/parameters/scope'
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/measure'
                type: object
                properties:
                  indices:
                    type: array
                    items:
                      type: object
                    description: Description of indices
                    example:
                    - station id: null
                      date start:
                        '0': component id
                        '1': scope id
                        '2': value
                        '3': date end
                        '4': index
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        station id:
                          type: object
                          description: The id of the station
                          properties:
                            date start (CET):
                              type: array
                              description: The datetime in CET when the measuring was started
                              items:
                                $ref: '#/components/schemas/measure'
                      example:
                        '7':
                          '2019-01-01 00:00:00':
                            '0': 1
                            '1': 6
                            '2': 17.1
                            '3': '2019-01-01 01:00:00'
                            '4': null
        '422':
          description: required parameter is missing.
      summary: Get all measurements
      tags:
      - Measurements
      operationId: getMeasuresJson
      x-operation-id-source: derived
    servers:
    - url: https://www.umweltbundesamt.de/api/air_data/v2
      description: Public API
  /measures/limits:
    get:
      description: This entry point returns all limits of measurements
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                type: object
                properties:
                  indices:
                    type: object
                    description: Description of indices
                    example:
                      combination of scope id, component id, station id:
                        '0': scope id
                        '1': component id
                        '2': station id
                        '3': limit date start min (CET)
                        '4': limit date start max (CET)
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        concatId:
                          $ref: '#/components/schemas/measurelimit'
                      example:
                        '11620':
                          '0': 1
                          '1': 1
                          '2': 620
                          '3': '2016-01-01 11:00:00'
                          '4': '2019-09-01 11:00:00'
      summary: Get measurement date limits
      tags:
      - Measurements
      operationId: getMeasuresLimits
      x-operation-id-source: derived
    servers:
    - url: https://www.umweltbundesamt.de/api/air_data/v2
      description: Public API
components:
  parameters:
    component:
      name: component
      description: Id of component
      in: query
      required: false
      schema:
        type: integer
      example: 1
    dateFromReq:
      name: date_from
      description: A date
      in: query
      required: true
      schema:
        format: YYYY-MM-DD
        type: string
      example: '2019-01-01'
    timeToReq:
      name: time_to
      description: An hour.
      in: query
      required: true
      schema:
        type: integer
        minimum: 1
        maximum: 24
      example: 9
    timeFromReq:
      name: time_from
      description: An hour.
      in: query
      required: true
      schema:
        type: integer
        minimum: 1
        maximum: 24
      example: 9
    dateToReq:
      name: date_to
      description: A date
      in: query
      required: true
      schema:
        format: YYYY-MM-DD
        type: string
      example: '2019-01-01'
    station:
      name: station
      description: Id of station
      in: query
      schema:
        type: integer
      example: 769
    scope:
      name: scope
      description: Id of scope
      in: query
      schema:
        type: integer
      example: 2
  schemas:
    measurelimit:
      type: object
      description: The index is a concatination of scope id, component id and station id.
      properties:
        '0':
          description: Id of scope
          example: 2
          format: integer
          type: integer
        '1':
          description: Id of component
          example: 2
          format: integer
          type: integer
        '2':
          description: Id of station
          example: 2
          format: integer
          type: integer
        '3':
          description: Mimimum datetime of start (CET)
          example: 2019-01-02 11:00:00+00:00
          format: YYYY-MM-DD HH:mm:ss
          type: string
        '4':
          description: Maximum datetime of start (CET)
          example: 2019-01-02 12:00:00+00:00
          format: YYYY-MM-DD HH:mm:ss
          type: string
    measure:
      type: object
      properties:
        '0':
          description: Id of component
          example: 2
          type: integer
        '1':
          description: Id of scope
          example: 2
          type: integer
        '2':
          description: Value of measurement
          example: 112.4
          type:
          - number
          - 'null'
        '3':
          description: Date end (CET)
          example: '2019-01-01 02:00:00'
          format: YYYY-MM-DD HH:mm:ss
          type: string
        '4':
          description: Air quality index
          example: 1
          type:
          - integer
          - 'null'
x-refined-from:
- luftqualitaet.yaml
- bund-dev-luftqualitaet-openapi.yml