bund.dev

bund.dev Metadata API

The metadata API from bund.dev — 8 operation(s) for metadata.

Documentation GitHub OpenAPI

Operations 8

GET /components/json Get all components #

GET /networks/json Get all networks #

GET /scopes/json Get all scopes #

GET /stationsettings/json Get all station settings #

GET /stationtypes/json Get all station types #

GET /thresholds/json Get all thresholds #

GET /transgressiontypes/json Get all exceedances types #

GET /meta/json Get combined metadata for use #

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-metadata-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.

GitHub Google LinkedIn

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

OpenAPI Specification

openapi: 3.2.0
info:
  title: Bund Dev Metadata API
  version: 2.0.1
  contact:
    email: immission@uba.de
    name: API Support
  description: 'Operations tagged metadata 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: Metadata
  x-displayName: Meta data
paths:
  /components/json:
    get:
      description: This entry point returns a list of all components.
      parameters:
      - $ref: '#/components/parameters/lang'
      - $ref: '#/components/parameters/index'
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                type: object
                example:
                  '5':
                    '0': 5
                    '1': NO2
                    '2': NO₂
                    '3': µg/m³
                    '4': Nitrogen dioxide
                  NO2:
                    '0': 5
                    '1': NO2
                    '2': NO₂
                    '3': µg/m³
                    '4': Nitrogen dioxide
                properties:
                  id|code:
                    $ref: '#/components/schemas/component'
      summary: Get all components
      tags:
      - Metadata
      operationId: getComponentsJson
      x-operation-id-source: derived
    servers:
    - url: https://www.umweltbundesamt.de/api/air_data/v2
      description: Public API
  /networks/json:
    get:
      description: This entry point returns a list of all networks.
      parameters:
      - $ref: '#/components/parameters/lang'
      - $ref: '#/components/parameters/index'
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/network'
                properties:
                  indices:
                    type: array
                    items:
                      type: string
                    description: Description of indices
                    example:
                    - network id
                    - network code
                    - network name
                  data:
                    type: object
                    properties:
                      id|code:
                        $ref: '#/components/schemas/network'
                    example:
                      '1':
                        '0': 2
                        '1': BY
                        '2': Bayern
                      BY:
                        '0': 2
                        '1': BY
                        '2': Bayern
                type: object
      summary: Get all networks
      tags:
      - Metadata
      operationId: getNetworksJson
      x-operation-id-source: derived
    servers:
    - url: https://www.umweltbundesamt.de/api/air_data/v2
      description: Public API
  /scopes/json:
    get:
      description: The entry point returns a list of all scopes.
      parameters:
      - $ref: '#/components/parameters/lang'
      - $ref: '#/components/parameters/index'
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                example:
                  '2':
                    '0': 2
                    '1': 1SMW
                    '2': hour
                    '3': 3600
                    '4': 0
                    '5': 1-hour average
                  1SMW:
                    '0': 2
                    '1': 1SMW
                    '2': hour
                    '3': 3600
                    '4': 0
                    '5': 1-hour average
                properties:
                  id|code:
                    $ref: '#/components/schemas/scope'
                type: object
      summary: Get all scopes
      tags:
      - Metadata
      operationId: getScopesJson
      x-operation-id-source: derived
    servers:
    - url: https://www.umweltbundesamt.de/api/air_data/v2
      description: Public API
  /stationsettings/json:
    get:
      description: This entry point returns a list of all station settings.
      parameters:
      - $ref: '#/components/parameters/lang'
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/stationsetting'
                type: array
      summary: Get all station settings
      tags:
      - Metadata
      operationId: getStationsettingsJson
      x-operation-id-source: derived
    servers:
    - url: https://www.umweltbundesamt.de/api/air_data/v2
      description: Public API
  /stationtypes/json:
    get:
      description: This entry point returns a list of all station types.
      parameters:
      - $ref: '#/components/parameters/lang'
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/stationtype'
                type: array
      summary: Get all station types
      tags:
      - Metadata
      operationId: getStationtypesJson
      x-operation-id-source: derived
    servers:
    - url: https://www.umweltbundesamt.de/api/air_data/v2
      description: Public API
  /thresholds/json:
    get:
      description: This entry point returns a list of all thresholds
      parameters:
      - $ref: '#/components/parameters/usethreshold'
      - $ref: '#/components/parameters/lang'
      - $ref: '#/components/parameters/component'
      - $ref: '#/components/parameters/scope'
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/threshold'
                type: array
        '422':
          description: required parameter is missing.
      summary: Get all thresholds
      tags:
      - Metadata
      operationId: getThresholdsJson
      x-operation-id-source: derived
    servers:
    - url: https://www.umweltbundesamt.de/api/air_data/v2
      description: Public API
  /transgressiontypes/json:
    get:
      description: Returns all exceedances types
      parameters:
      - $ref: '#/components/parameters/lang'
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/transgressiontype'
      summary: Get all exceedances types
      tags:
      - Metadata
      operationId: getTransgressiontypesJson
      x-operation-id-source: derived
    servers:
    - url: https://www.umweltbundesamt.de/api/air_data/v2
      description: Public API
  /meta/json:
    get:
      parameters:
      - $ref: '#/components/parameters/use'
      - $ref: '#/components/parameters/lang'
      - $ref: '#/components/parameters/dateFromAq'
      - $ref: '#/components/parameters/dateToAq'
      - $ref: '#/components/parameters/timeFromAq'
      - $ref: '#/components/parameters/timeToAq'
      summary: Get combined metadata for use
      description: The use parameter defines what meta data should be returned. E.g. if you set use to airquality, meta data of airquality is returned.
      tags:
      - Metadata
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                type: object
                properties:
                  components:
                    description: components (available for use = airquality, map, transgression, annualbalance, measure)
                    type: array
                    items:
                      type: object
                      properties:
                        id of component:
                          $ref: '#/components/schemas/component'
                      example:
                        '5':
                          '0': 5
                          '1': NO2
                          '2': NOÃ¢â€šâ€š
                          '3': Ã‚Âµg/mÃ‚Â³
                          '4': Nitrogen dioxid
                  scopes:
                    description: scopes (available for use = airquality, map, measure)
                    type: array
                    items:
                      type: object
                      properties:
                        id of scope:
                          $ref: '#/components/schemas/scope'
                      example:
                        '2':
                          '0': 2
                          '1': 1SMW
                          '2': hour
                          '3': 3600
                          '4': 0
                          '5': 1-hour average
                  networks:
                    description: networks (available for use = air quality, transgression, annualbalance, measure)
                    type: array
                    items:
                      type: object
                      properties:
                        id of network:
                          $ref: '#/components/schemas/network'
                      example:
                        '2':
                          '0': 2
                          '1': BY
                          '2': Bavaria
                  stations:
                    description: stations (available for use = airquality, transgression, annualbalance, measure)
                    type: array
                    items:
                      type: object
                      properties:
                        id of station:
                          $ref: '#/components/schemas/station'
                      example:
                        '769':
                          '0': 769
                          '1': DEHH016
                          '2': Hamburg Billbrook
                          '3': Hamburg
                          '4': 21BI
                          '5': 1985-01-01 00:00:00+00:00
                          '6': 1985-01-01 00:00:00+00:00
                          '7': 10.0817
                          '8': 53.529
                          '9': 6
                          '10': 1
                          '11': 2
                          '12': HH
                          '13': Hamburg
                          '14': urban area
                          '15': urban
                          '16': industry
                  limits-1:
                    description: Limits (available for use = airquality, measure)
                    type: array
                    items:
                      type: object
                      properties:
                        concat of component id, scope id, station id:
                          $ref: '#/components/schemas/limit'
                      example:
                        '11120':
                          '0': 1
                          '1': 1
                          '2': 120
                          '3': 2016-01-01 11:00:00+00:00
                          '4': 2019-09-02 11:00:00+00:00
                  limits-2:
                    description: Limits (available for use = annualbalance)
                    type: array
                    items:
                      type: object
                      properties:
                        '0':
                          description: Year
                          example: 2004
                          type: integer
                          minLength: 4
                          maxLength: 4
                        '1':
                          description: Id of component
                          example: 1
                          type: integer
                  xref:
                    description: Cross reference component/scope (available for use = map, measure)
                    type: array
                    items:
                      type: object
                      properties:
                        '0':
                          description: Id of component
                          example: 2
                          type: integer
                        '1':
                          description: Id of scope
                          example: 4
                          type: integer
                        '2':
                          description: Flag if this combination of component and scope has a map
                          example: 1
                          type: integer
                          minimum: 0
                          maximum: 1
                        '3':
                          description: Flag if this combination of component and scope has an alternative map
                          example: 0
                          type: integer
                          minimum: 0
                          maximum: 1
                        '4':
                          description: Flag if this combination of component and scope is an hourly value
                          example: 1
                          type: integer
                          minimum: 0
                          maximum: 1
        '422':
          description: required parameter is missing.
      operationId: getMetaJson
      x-operation-id-source: derived
    servers:
    - url: https://www.umweltbundesamt.de/api/air_data/v2
      description: Public API
components:
  schemas:
    stationtype:
      type: object
      properties:
        '0':
          description: Id of station type
          example: 2
          format: integer
          type: integer
        '1':
          description: Name of station type in specified language
          example: industry
          type: string
    network:
      type: object
      properties:
        '0':
          description: Id of network
          example: 2
          format: integer
          type: integer
        '1':
          description: Network short code
          example: BY
          type: string
        '2':
          description: Networks name in specified language
          example: Bavaria
          type: string
    limit:
      type: object
      description: The index is a concatination of scope id, component id and station id.
      properties:
        '0':
          description: Id of scope
          example: '1'
          format: integer
          type: string
        '1':
          description: Id of component
          example: '1'
          format: integer
          type: string
        '2':
          description: Id of station
          example: '120'
          format: integer
          type: string
        '3':
          description: Minimum datetime of start (CET)
          example: '2016-01-01T11:00:00.000Z'
          format: YYYY-MM-DD HH:mm:ss
          type: string
        '4':
          description: Maximum datetime of start (CET)
          example: '2019-09-02T11:00:00.000Z'
          format: YYYY-MM-DD HH:mm:ss
          type: string
    scope:
      type: object
      properties:
        '0':
          description: Id of scope
          example: 2
          format: integer
          type: integer
        '1':
          description: Scope code
          example: 1SMW
          type: string
        '2':
          description: Scope time base
          example: hour
          type: string
        '3':
          description: Scope time scope
          example: 3600
          format: integer
          type: integer
        '4':
          description: Scope time is max
          enum:
          - 0
          - 1
          example: 0
          format: integer
          type: integer
        '5':
          description: Scope name in specified language
          example: 1-hour average
          type: string
    threshold:
      type: object
      properties:
        '0':
          description: Id of threshold
          example: 5
          format: integer
          type: integer
        '1':
          description: Id of component
          example: 5
          type: integer
        '2':
          description: Id of scope
          example: 1
          type: integer
        '3':
          description: Threshold minimum value
          example: 201
          type: integer
        '4':
          description: Threshold maximum value
          example: 1000
          type: integer
        '5':
          description: Threshold index
          example: 4
          type: integer
    stationsetting:
      type: object
      properties:
        '0':
          description: Id of station setting
          example: 2
          format: integer
          type: integer
        '1':
          description: Name of station setting in specified language
          example: suburban area
          type: string
        '2':
          description: Short name of station setting in specified language
          example: suburban
          type: string
    station:
      type: object
      properties:
        '0':
          description: Id of station
          example: '769'
          type: string
          format: interger
        '1':
          description: Code of station
          example: DEHH016
          type: string
        '2':
          description: Name of station
          example: Hamburg Billbrook
          type: string
        '3':
          description: City of station
          example: Hamburg
          type: string
        '4':
          description: Synonym of station
          example: 21BI
          type: string
        '5':
          description: Date of first activity
          example: '1985-01-01T00:00:00.000Z'
          format: YYYY-MM-DD
          type: string
        '6':
          description: Date of last activity (null when still running)
          example: '1985-01-01T00:00:00.000Z'
          format: YYYY-MM-DD
          type:
          - string
          - 'null'
        '7':
          description: Longitude of station
          example: '10.0817'
          type: string
          format: float
        '8':
          description: Latitude of station
          example: '53.529'
          type: string
          format: float
        '9':
          description: Id of network
          example: '6'
          type: string
          format: integer
        '10':
          description: Id of station setting
          example: '1'
          type: string
          format: integer
        '11':
          description: Id of station type
          example: '2'
          type: string
          format: integer
        '12':
          description: Code of network
          example: HH
          type: string
        '13':
          description: Name of network in specified language
          example: Hamburg
          type: string
        '14':
          description: Name of station setting in specified language
          example: urban area
          type: string
        '15':
          description: Short name of station setting in specified language
          example: urban
          type: string
        '16':
          description: Name of station type in specified language
          example: industry
          type: string
        '17':
          description: Street of station
          example: Lauchhammerstr.
          type: string
        '18':
          description: Street number of station
          example: '23'
          type: string
        '19':
          description: ZIP code of station
          example: 04910
          type: string
    component:
      type: object
      properties:
        '0':
          description: Id of component
          example: 5
          format: integer
          type: integer
        '1':
          description: Component code
          example: NO2
          type: string
        '2':
          description: Component symbol
          example: NO₂
          type: string
        '3':
          description: Component unit
          example: µg/m³
          type: string
        '4':
          description: Components name in specified language
          example: Nitrogen dioxide
          type: string
    transgressiontype:
      type: object
      properties:
        '0':
          description: Id of exceedance type
          example: 2
          format: integer
          type: integer
        '1':
          description: Name of exceedance type in specified language
          example: Jahresmittelwert in µg/m³
          type: string
  parameters:
    timeToAq:
      name: time_to
      description: An hour.
      in: query
      schema:
        type: integer
        minimum: 1
        maximum: 24
      example: 9
    lang:
      name: lang
      description: The language code
      in: query
      required: false
      schema:
        type: string
        default: en
        enum:
        - en
        - de
      example: de
    dateFromAq:
      name: date_from
      description: A date (required only for use = airquality)
      in: query
      required: false
      schema:
        format: YYYY-MM-DD
        type: string
      example: '2019-01-01'
    component:
      name: component
      description: Id of component
      in: query
      required: false
      schema:
        type: integer
      example: 1
    use:
      name: use
      in: query
      description: Defines the use.
      required: true
      schema:
        enum:
        - airquality
        - measure
        - transgression
        - annualbalance
        - map
        type: string
      example: airquality
    usethreshold:
      name: use
      description: Defines which thresholds to use.
      in: query
      required: true
      schema:
        enum:
        - airquality
        - measure
        type: string
      example: airquality
    timeFromAq:
      name: time_from
      description: An hour.
      in: query
      schema:
        type: integer
        minimum: 1
        maximum: 24
      example: 9
    scope:
      name: scope
      description: Id of scope
      in: query
      schema:
        type: integer
      example: 2
    index:
      name: index
      description: The type of index to be used
      in: query
      required: false
      schema:
        default: id
        enum:
        - id
        - code
      example: code
    dateToAq:
      name: date_to
      description: A date (required only for use = airquality)
      in: query
      required: false
      schema:
        format: YYYY-MM-DD
        type: string
      example: '2019-01-01'
x-refined-from:
- luftqualitaet.yaml
- bund-dev-luftqualitaet-openapi.yml