{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/infranode-dev/json-schema/infranode-dev-canonical-record-schema.json",
  "title": "CanonicalRecord",
  "x-generated": "2026-10-31",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/infranode-dev-openapi.yaml#/components/schemas/CanonicalRecord",
  "type": "object",
  "required": [
    "city_slug",
    "retrieved_at",
    "source",
    "license_id",
    "license_tier",
    "schema_version",
    "record_id",
    "content_hash",
    "attribution",
    "payload"
  ],
  "properties": {
    "city_slug": {
      "type": "string"
    },
    "schema_version": {
      "type": "integer",
      "default": 1
    },
    "record_id": {
      "type": "string",
      "description": "Deterministischer Primärschlüssel (computed, immer im Dump)."
    },
    "content_hash": {
      "type": "string",
      "description": "Deterministischer Dedup-Hash der Nutzdaten (computed, immer im Dump)."
    },
    "ags": {
      "type": [
        "string",
        "null"
      ],
      "description": "Amtlicher Gemeindeschlüssel als Join-Key (kein Pfadsegment)."
    },
    "wikidata_qid": {
      "type": [
        "string",
        "null"
      ],
      "description": "Wikidata-QID als Join-Key."
    },
    "geo": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "lat": {
          "type": "number"
        },
        "lon": {
          "type": "number"
        }
      }
    },
    "observed_at": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "retrieved_at": {
      "type": "string",
      "format": "date-time"
    },
    "source": {
      "type": "string",
      "description": "Kanonischer Quellname (SourceId). Seit 2026-08-01 tragen alle Quellen einheitlich englische Namen; historische Antworten und Bestandsdaten konnten davor alte deutsche Quellnamen tragen (z.B. hamburg_baustellen statt hamburg_roadworks). Die vollständige Zuordnungstabelle alt -> neu steht im Changelog (Eintrag 2026-08-01).",
      "x-description-en": "Canonical source name (SourceId). Since 2026-08-01 all sources carry uniform English names; historical responses and stored records may still carry the former German source names (e.g. hamburg_baustellen instead of hamburg_roadworks). The full old -> new mapping table is in the changelog (entry 2026-08-01).",
      "enum": [
        "wikidata",
        "dwd",
        "osm",
        "autobahn",
        "bnetza",
        "uba",
        "delfi",
        "hvv",
        "pegelonline",
        "lhp",
        "dwd_pollen",
        "dwd_fire",
        "eea_bathing",
        "klinik_atlas",
        "db_fasta",
        "genesis",
        "zensus",
        "mastr",
        "smard",
        "dwd_warnings",
        "bkg",
        "bundeswahl",
        "holidays",
        "berlin_viz",
        "hamburg_roadworks",
        "koeln_road_events",
        "muenchen_roadworks",
        "dortmund_roadworks",
        "rostock_roadworks",
        "sperrinfosys",
        "mobidata_bw",
        "destination_one",
        "koeln_events",
        "koeln_traffic_flow",
        "koeln_roadworks_live",
        "koeln_incidents_live",
        "koeln_lez_live",
        "berlin_traffic_reports",
        "dortmund_parking",
        "kiel_counting_stations",
        "eround_charging",
        "frankfurt_parking",
        "wuppertal_parking",
        "magdeburg_parking",
        "koeln_parking",
        "gtfs_rt",
        "hvv_geofox",
        "vgn",
        "rmv",
        "vrr",
        "vvs",
        "hamburg_traffic_situation",
        "kba",
        "unfallatlas",
        "tankerkoenig",
        "bremen_roadworks",
        "hannover_traffic_reports",
        "gbfs",
        "inkar",
        "wegweiser",
        "bka_pks",
        "db_timetables",
        "boris",
        "stada",
        "regionalstatistik",
        "solar",
        "solar_cadastre",
        "muenchen_parking",
        "muenchen_bike_counts",
        "muenchen_parking_onstreet",
        "muenchen_park_and_ride",
        "muenchen_mobility_points",
        "muenchen_bike_parking",
        "leipzig_bike_counts",
        "hamburg_bike_counts",
        "berlin_bike_counts",
        "stuttgart_bike_counts",
        "koeln_bike_counts",
        "essen_bike_counts",
        "duesseldorf_bike_counts",
        "parkendd",
        "heritage",
        "tree_cadastre",
        "zensus_grid",
        "oeffentlichevergabe",
        "district_heating",
        "koeln_wait_times",
        "bbk_nina",
        "council",
        "mobidata_parkapi",
        "pr_hessen_parking",
        "db_bahnpark",
        "muenster_parking",
        "aachen_parking",
        "oldenburg_parking",
        "kaiserslautern_parking",
        "dresden_parking",
        "karlsruhe_parking",
        "hamburg_parking"
      ]
    },
    "license_id": {
      "type": "string",
      "enum": [
        "cc0",
        "cc_by_4_0",
        "dl_de_by_2_0",
        "dl_de_zero_2_0",
        "geonutzv",
        "odbl",
        "cc_by_sa_4_0",
        "ec_reuse",
        "unknown",
        "amtliches_werk"
      ]
    },
    "license_tier": {
      "type": "string",
      "enum": [
        "A",
        "B",
        "C"
      ]
    },
    "attribution": {
      "$ref": "#/$defs/Attribution"
    },
    "payload": {
      "oneOf": [
        {
          "$ref": "#/$defs/CityBaseDataPayload"
        },
        {
          "$ref": "#/$defs/AirQualityPayload"
        },
        {
          "$ref": "#/$defs/WeatherPayload"
        },
        {
          "$ref": "#/$defs/PoiPayload"
        },
        {
          "$ref": "#/$defs/TrafficEventPayload"
        },
        {
          "$ref": "#/$defs/TransitStopPayload"
        },
        {
          "$ref": "#/$defs/ChargingStationPayload"
        },
        {
          "$ref": "#/$defs/WaterLevelPayload"
        },
        {
          "$ref": "#/$defs/FloodWarningPayload"
        },
        {
          "$ref": "#/$defs/PollenUvPayload"
        },
        {
          "$ref": "#/$defs/DemographicsPayload"
        },
        {
          "$ref": "#/$defs/EnergyAssetPayload"
        },
        {
          "$ref": "#/$defs/AdminBoundaryPayload"
        },
        {
          "$ref": "#/$defs/ElectionResultPayload"
        },
        {
          "$ref": "#/$defs/HolidayPayload"
        },
        {
          "$ref": "#/$defs/HospitalPayload"
        },
        {
          "$ref": "#/$defs/RoadEventPayload"
        },
        {
          "$ref": "#/$defs/AccidentPayload"
        },
        {
          "$ref": "#/$defs/BathingWaterPayload"
        },
        {
          "$ref": "#/$defs/BikeParkingPayload"
        },
        {
          "$ref": "#/$defs/BusinessRegistrationsPayload"
        },
        {
          "$ref": "#/$defs/ChargingStatusCityPayload"
        },
        {
          "$ref": "#/$defs/ChargingStatusPayload"
        },
        {
          "$ref": "#/$defs/CivilProtectionWarningPayload"
        },
        {
          "$ref": "#/$defs/CountStationPayload"
        },
        {
          "$ref": "#/$defs/CrimeStatsPayload"
        },
        {
          "$ref": "#/$defs/DistrictHeatingPayload"
        },
        {
          "$ref": "#/$defs/EventPayload"
        },
        {
          "$ref": "#/$defs/FireDangerPayload"
        },
        {
          "$ref": "#/$defs/FuelPricePayload"
        },
        {
          "$ref": "#/$defs/HospitalAtlasPayload"
        },
        {
          "$ref": "#/$defs/IndicatorSeriesPayload"
        },
        {
          "$ref": "#/$defs/IndicatorsPayload"
        },
        {
          "$ref": "#/$defs/InsolvenciesPayload"
        },
        {
          "$ref": "#/$defs/LandValuesPayload"
        },
        {
          "$ref": "#/$defs/MobilityPointPayload"
        },
        {
          "$ref": "#/$defs/OfficeWaitTimesPayload"
        },
        {
          "$ref": "#/$defs/ParkAndRidePayload"
        },
        {
          "$ref": "#/$defs/ParkingOnStreetPayload"
        },
        {
          "$ref": "#/$defs/ParkingPayload"
        },
        {
          "$ref": "#/$defs/PopulationDensityPayload"
        },
        {
          "$ref": "#/$defs/PowerPayload"
        },
        {
          "$ref": "#/$defs/PublicTenderPayload"
        },
        {
          "$ref": "#/$defs/RegionalStatPayload"
        },
        {
          "$ref": "#/$defs/SharingPayload"
        },
        {
          "$ref": "#/$defs/SolarPayload"
        },
        {
          "$ref": "#/$defs/SolarRoofsPayload"
        },
        {
          "$ref": "#/$defs/StationArrivalsPayload"
        },
        {
          "$ref": "#/$defs/StationCatalogPayload"
        },
        {
          "$ref": "#/$defs/StationDeparturesPayload"
        },
        {
          "$ref": "#/$defs/StationFacilityPayload"
        },
        {
          "$ref": "#/$defs/TaxRatesPayload"
        },
        {
          "$ref": "#/$defs/TrafficFlowPayload"
        },
        {
          "$ref": "#/$defs/TransitDeparturePayload"
        },
        {
          "$ref": "#/$defs/TransitRouteStatusPayload"
        },
        {
          "$ref": "#/$defs/TransitTripPayload"
        },
        {
          "$ref": "#/$defs/VehicleRegistrationPayload"
        },
        {
          "$ref": "#/$defs/WeatherWarningPayload"
        }
      ]
    }
  },
  "$defs": {
    "AccidentPayload": {
      "type": "object",
      "required": [
        "kind"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "accident"
          ],
          "default": "accident"
        },
        "reference_year": {
          "type": [
            "integer",
            "null"
          ]
        },
        "total": {
          "type": [
            "integer",
            "null"
          ]
        },
        "fatal": {
          "type": [
            "integer",
            "null"
          ]
        },
        "serious": {
          "type": [
            "integer",
            "null"
          ]
        },
        "light": {
          "type": [
            "integer",
            "null"
          ]
        },
        "with_bicycle": {
          "type": [
            "integer",
            "null"
          ]
        },
        "with_pedestrian": {
          "type": [
            "integer",
            "null"
          ]
        },
        "with_car": {
          "type": [
            "integer",
            "null"
          ]
        },
        "with_motorcycle": {
          "type": [
            "integer",
            "null"
          ]
        },
        "district_key": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    },
    "AdminBoundaryPayload": {
      "type": "object",
      "required": [
        "kind"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "admin_boundary"
          ],
          "default": "admin_boundary"
        },
        "ags": {
          "type": [
            "string",
            "null"
          ]
        },
        "gen_name": {
          "type": [
            "string",
            "null"
          ]
        },
        "area_km2": {
          "type": [
            "number",
            "null"
          ]
        },
        "reference_year": {
          "type": [
            "integer",
            "null"
          ]
        }
      }
    },
    "AirQualityPayload": {
      "type": "object",
      "required": [
        "kind"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "air_quality"
          ],
          "default": "air_quality"
        },
        "station_id": {
          "type": [
            "string",
            "null"
          ]
        },
        "pm10": {
          "type": [
            "number",
            "null"
          ]
        },
        "no2": {
          "type": [
            "number",
            "null"
          ]
        },
        "pm25": {
          "type": [
            "number",
            "null"
          ]
        },
        "o3": {
          "type": [
            "number",
            "null"
          ]
        },
        "so2": {
          "type": [
            "number",
            "null"
          ]
        }
      }
    },
    "Attribution": {
      "type": "object",
      "required": [
        "text"
      ],
      "properties": {
        "text": {
          "type": "string"
        },
        "license_url": {
          "type": [
            "string",
            "null"
          ]
        },
        "modified": {
          "type": "boolean",
          "default": false
        }
      }
    },
    "BathingWaterPayload": {
      "type": "object",
      "required": [
        "kind"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "bathing_water"
          ],
          "default": "bathing_water"
        },
        "season_year": {
          "type": [
            "integer",
            "null"
          ]
        },
        "count": {
          "type": "integer",
          "default": 0
        },
        "counts": {
          "type": "object"
        },
        "sites": {
          "type": "array",
          "items": {
            "type": "object"
          }
        },
        "truncated": {
          "type": "boolean",
          "default": false
        }
      }
    },
    "BikeParkingPayload": {
      "type": "object",
      "required": [
        "kind"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "bike_parking"
          ],
          "default": "bike_parking"
        },
        "facility_count": {
          "type": [
            "integer",
            "null"
          ]
        },
        "spaces_total": {
          "type": [
            "integer",
            "null"
          ]
        },
        "covered_facilities": {
          "type": [
            "integer",
            "null"
          ]
        },
        "double_deck_facilities": {
          "type": [
            "integer",
            "null"
          ]
        },
        "lit_facilities": {
          "type": [
            "integer",
            "null"
          ]
        },
        "time_limited_facilities": {
          "type": [
            "integer",
            "null"
          ]
        },
        "bike_and_ride_facilities": {
          "type": [
            "integer",
            "null"
          ]
        },
        "bike_and_ride_spaces": {
          "type": [
            "integer",
            "null"
          ]
        },
        "planned_facilities": {
          "type": [
            "integer",
            "null"
          ]
        },
        "planned_spaces": {
          "type": [
            "integer",
            "null"
          ]
        },
        "removed_facilities": {
          "type": [
            "integer",
            "null"
          ]
        },
        "out_of_service_facilities": {
          "type": [
            "integer",
            "null"
          ]
        },
        "by_type": {
          "type": "array",
          "items": {
            "type": "object"
          }
        },
        "cargo_bike": {
          "type": [
            "object",
            "null"
          ]
        },
        "largest_facilities": {
          "type": "array",
          "items": {
            "type": "object"
          }
        }
      }
    },
    "BusinessRegistrationsPayload": {
      "type": "object",
      "required": [
        "kind"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "business_registrations"
          ],
          "default": "business_registrations"
        },
        "registrations": {
          "type": [
            "integer",
            "null"
          ]
        },
        "deregistrations": {
          "type": [
            "integer",
            "null"
          ]
        },
        "balance": {
          "type": [
            "integer",
            "null"
          ]
        },
        "year": {
          "type": [
            "integer",
            "null"
          ]
        }
      }
    },
    "ChargingStationPayload": {
      "type": "object",
      "required": [
        "kind",
        "count"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "charging_station"
          ],
          "default": "charging_station"
        },
        "count": {
          "type": "integer"
        },
        "stations": {
          "type": "array",
          "items": {
            "type": "object"
          }
        }
      }
    },
    "ChargingStatusCityPayload": {
      "type": "object",
      "required": [
        "kind"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "charging_status_city"
          ],
          "default": "charging_status_city"
        },
        "total_points": {
          "type": "integer",
          "default": 0
        },
        "reported_points": {
          "type": "integer",
          "default": 0
        },
        "status_counts": {
          "type": "object",
          "additionalProperties": {
            "type": "integer"
          }
        },
        "points": {
          "type": "array",
          "items": {
            "type": "object"
          }
        },
        "truncated": {
          "type": "boolean",
          "default": false
        }
      }
    },
    "ChargingStatusPayload": {
      "type": "object",
      "required": [
        "kind"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "charging_status"
          ],
          "default": "charging_status"
        },
        "points": {
          "type": "array",
          "items": {
            "type": "object"
          }
        }
      }
    },
    "CityBaseDataPayload": {
      "type": "object",
      "required": [
        "kind"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "city_base"
          ],
          "default": "city_base"
        },
        "population": {
          "type": [
            "integer",
            "null"
          ]
        },
        "area_km2": {
          "type": [
            "number",
            "null"
          ]
        }
      }
    },
    "CivilProtectionWarningPayload": {
      "type": "object",
      "required": [
        "kind"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "civil_protection_warning"
          ],
          "default": "civil_protection_warning"
        },
        "ars": {
          "type": [
            "string",
            "null"
          ]
        },
        "coverage_granularity": {
          "type": [
            "string",
            "null"
          ]
        },
        "count": {
          "type": "integer",
          "default": 0
        },
        "warnings": {
          "type": "array",
          "items": {
            "type": "object"
          }
        }
      }
    },
    "CountStationPayload": {
      "type": "object",
      "required": [
        "kind"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "count_station"
          ],
          "default": "count_station"
        },
        "counts": {
          "type": "array",
          "items": {
            "type": "object"
          }
        }
      }
    },
    "CrimeStatsPayload": {
      "type": "object",
      "required": [
        "kind"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "crime_stats"
          ],
          "default": "crime_stats"
        },
        "reference_year": {
          "type": [
            "integer",
            "null"
          ]
        },
        "version": {
          "type": [
            "string",
            "null"
          ]
        },
        "groups": {
          "type": "array",
          "items": {
            "type": "object"
          }
        }
      }
    },
    "DemographicsPayload": {
      "type": "object",
      "required": [
        "kind"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "demographics"
          ],
          "default": "demographics"
        },
        "population": {
          "type": [
            "integer",
            "null"
          ]
        },
        "households": {
          "type": [
            "integer",
            "null"
          ]
        },
        "buildings": {
          "type": [
            "integer",
            "null"
          ]
        },
        "rent_avg": {
          "type": [
            "number",
            "null"
          ]
        },
        "reference_year": {
          "type": [
            "integer",
            "null"
          ]
        },
        "series": {
          "type": "array",
          "items": {
            "type": "object"
          }
        }
      }
    },
    "DistrictHeatingPayload": {
      "type": "object",
      "required": [
        "kind"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "district_heating"
          ],
          "default": "district_heating"
        },
        "network_area_count": {
          "type": [
            "integer",
            "null"
          ]
        },
        "supplied_area_km2": {
          "type": [
            "number",
            "null"
          ]
        },
        "operator_count": {
          "type": [
            "integer",
            "null"
          ]
        },
        "operators": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "house_connections": {
          "type": [
            "integer",
            "null"
          ]
        },
        "network_length_km": {
          "type": [
            "number",
            "null"
          ]
        },
        "networks": {
          "type": "array",
          "items": {
            "type": "object"
          }
        },
        "area_basis": {
          "type": [
            "string",
            "null"
          ]
        },
        "reference_date": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    },
    "ElectionResultPayload": {
      "type": "object",
      "required": [
        "kind"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "election_result"
          ],
          "default": "election_result"
        },
        "election": {
          "type": [
            "string",
            "null"
          ]
        },
        "coverage_granularity": {
          "type": [
            "string",
            "null"
          ],
          "description": "Abdeckungs-Granularität (kanonischer Name): \"city\" = stadtgenau aus den Wahlkreisen der Stadt aggregiert, \"partial\" = Wahlkreis/Kreis- Ebene, Stadt nur teilweise. Ersetzt das abgekündigte granularity.",
          "x-description-en": "Coverage granularity (canonical name): \"city\" = city-exact, aggregated from the city's constituencies, \"partial\" = constituency/district level, city only partially covered. Replaces the deprecated granularity."
        },
        "area_name": {
          "type": [
            "string",
            "null"
          ]
        },
        "turnout": {
          "type": [
            "string",
            "null"
          ],
          "description": "Wahlbeteiligung in Prozent als String mit Dezimal-Komma (kerg2, Zeile Gruppenname \"Wählende\", Spalte Prozent), z.B. \"82,5122\"."
        },
        "results": {
          "type": "array",
          "items": {
            "type": "object"
          }
        }
      }
    },
    "EnergyAssetPayload": {
      "type": "object",
      "required": [
        "kind",
        "count"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "energy_asset"
          ],
          "default": "energy_asset"
        },
        "count": {
          "type": "integer"
        },
        "by_type": {
          "type": "object"
        },
        "assets": {
          "type": "array",
          "items": {
            "type": "object"
          }
        },
        "total_power_kw": {
          "type": [
            "number",
            "null"
          ]
        },
        "power_by_type": {
          "type": "object"
        }
      }
    },
    "EventPayload": {
      "type": "object",
      "required": [
        "kind"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "event"
          ],
          "default": "event"
        },
        "city_source": {
          "type": [
            "string",
            "null"
          ]
        },
        "events": {
          "type": "array",
          "items": {
            "type": "object"
          }
        }
      }
    },
    "FireDangerPayload": {
      "type": "object",
      "required": [
        "kind"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "fire_danger"
          ],
          "default": "fire_danger"
        },
        "wbi_level": {
          "type": [
            "integer",
            "null"
          ]
        },
        "wbi_label": {
          "type": [
            "string",
            "null"
          ]
        },
        "glfi_level": {
          "type": [
            "integer",
            "null"
          ]
        },
        "glfi_label": {
          "type": [
            "string",
            "null"
          ]
        },
        "station_name": {
          "type": [
            "string",
            "null"
          ]
        },
        "station_id": {
          "type": [
            "string",
            "null"
          ]
        },
        "federal_state": {
          "type": [
            "string",
            "null"
          ]
        },
        "distance_km": {
          "type": [
            "number",
            "null"
          ]
        },
        "forecast_date": {
          "type": [
            "string",
            "null"
          ]
        },
        "updated_at": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    },
    "FloodWarningPayload": {
      "type": "object",
      "required": [
        "kind"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "flood_warning"
          ],
          "default": "flood_warning"
        },
        "warnings": {
          "type": "array",
          "items": {
            "type": "object"
          }
        },
        "as_of": {
          "type": [
            "string",
            "null"
          ],
          "description": "Stand-Zeitstempel-Text der LHP-Antwort (kanonischer Name; ersetzt das abgekündigte stand).",
          "x-description-en": "As-of timestamp text of the LHP response (canonical name; replaces the deprecated stand)."
        }
      }
    },
    "FuelPricePayload": {
      "type": "object",
      "required": [
        "kind"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "fuel_price"
          ],
          "default": "fuel_price"
        },
        "radius_km": {
          "type": [
            "number",
            "null"
          ]
        },
        "station_count": {
          "type": "integer",
          "default": 0
        },
        "open_count": {
          "type": "integer",
          "default": 0
        },
        "avg_e5": {
          "type": [
            "number",
            "null"
          ]
        },
        "avg_e10": {
          "type": [
            "number",
            "null"
          ]
        },
        "avg_diesel": {
          "type": [
            "number",
            "null"
          ]
        },
        "min_e5": {
          "type": [
            "number",
            "null"
          ]
        },
        "min_e10": {
          "type": [
            "number",
            "null"
          ]
        },
        "min_diesel": {
          "type": [
            "number",
            "null"
          ]
        },
        "stations": {
          "type": "array",
          "items": {
            "type": "object"
          }
        }
      }
    },
    "HolidayPayload": {
      "type": "object",
      "required": [
        "kind"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "holiday"
          ],
          "default": "holiday"
        },
        "state": {
          "type": [
            "string",
            "null"
          ]
        },
        "year": {
          "type": [
            "integer",
            "null"
          ]
        },
        "holidays": {
          "type": "array",
          "items": {
            "type": "object"
          }
        },
        "school_holidays": {
          "type": "array",
          "items": {
            "type": "object"
          }
        }
      }
    },
    "HospitalAtlasPayload": {
      "type": "object",
      "required": [
        "kind"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "hospital_atlas"
          ],
          "default": "hospital_atlas"
        },
        "count": {
          "type": "integer",
          "default": 0
        },
        "total_beds": {
          "type": [
            "integer",
            "null"
          ]
        },
        "truncated": {
          "type": "boolean",
          "default": false
        },
        "hospitals": {
          "type": "array",
          "items": {
            "type": "object"
          }
        }
      }
    },
    "HospitalPayload": {
      "type": "object",
      "required": [
        "kind",
        "count"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "hospital"
          ],
          "default": "hospital"
        },
        "count": {
          "type": "integer"
        },
        "hospitals": {
          "type": "array",
          "items": {
            "type": "object"
          }
        },
        "reference_date": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    },
    "IndicatorSeriesPayload": {
      "type": "object",
      "required": [
        "kind",
        "dataset"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "indicator_series"
          ],
          "default": "indicator_series"
        },
        "dataset": {
          "type": "string"
        },
        "indicator_count": {
          "type": "integer",
          "default": 0
        },
        "year_min": {
          "type": [
            "integer",
            "null"
          ]
        },
        "year_max": {
          "type": [
            "integer",
            "null"
          ]
        },
        "indicators": {
          "type": "array",
          "items": {
            "type": "object"
          }
        }
      }
    },
    "IndicatorsPayload": {
      "type": "object",
      "required": [
        "kind"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "indicators"
          ],
          "default": "indicators"
        },
        "indicator_count": {
          "type": "integer",
          "default": 0
        },
        "indicators": {
          "type": "array",
          "items": {
            "type": "object"
          }
        }
      }
    },
    "InsolvenciesPayload": {
      "type": "object",
      "required": [
        "kind"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "insolvencies"
          ],
          "default": "insolvencies"
        },
        "corporate_insolvencies": {
          "type": [
            "integer",
            "null"
          ]
        },
        "other_debtor_insolvencies": {
          "type": [
            "integer",
            "null"
          ]
        },
        "year": {
          "type": [
            "integer",
            "null"
          ]
        }
      }
    },
    "LandValuesPayload": {
      "type": "object",
      "required": [
        "kind"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "land_values"
          ],
          "default": "land_values"
        },
        "brw_median_eur_m2": {
          "type": [
            "number",
            "null"
          ]
        },
        "brw_min_eur_m2": {
          "type": [
            "number",
            "null"
          ]
        },
        "brw_max_eur_m2": {
          "type": [
            "number",
            "null"
          ]
        },
        "zone_count": {
          "type": "integer",
          "default": 0
        },
        "reference_date": {
          "type": [
            "string",
            "null"
          ]
        },
        "bbox_radius_deg": {
          "type": [
            "number",
            "null"
          ]
        },
        "normalized": {
          "type": "boolean",
          "default": false
        },
        "truncated": {
          "type": "boolean",
          "default": false
        }
      }
    },
    "MobilityPointPayload": {
      "type": "object",
      "required": [
        "kind"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "mobility_point"
          ],
          "default": "mobility_point"
        },
        "point_count": {
          "type": [
            "integer",
            "null"
          ]
        },
        "carsharing_area_count": {
          "type": [
            "integer",
            "null"
          ]
        },
        "carsharing_spaces": {
          "type": [
            "integer",
            "null"
          ]
        },
        "points": {
          "type": "array",
          "items": {
            "type": "object"
          }
        },
        "carsharing_areas": {
          "type": "array",
          "items": {
            "type": "object"
          }
        }
      }
    },
    "OfficeWaitTimesPayload": {
      "type": "object",
      "required": [
        "kind"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "office_wait_times"
          ],
          "default": "office_wait_times"
        },
        "offices": {
          "type": "array",
          "items": {
            "type": "object"
          }
        }
      }
    },
    "ParkAndRidePayload": {
      "type": "object",
      "required": [
        "kind"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "park_and_ride"
          ],
          "default": "park_and_ride"
        },
        "car_facility_count": {
          "type": [
            "integer",
            "null"
          ]
        },
        "car_spaces_total": {
          "type": [
            "integer",
            "null"
          ]
        },
        "bike_facility_count": {
          "type": [
            "integer",
            "null"
          ]
        },
        "bike_spaces_total": {
          "type": [
            "integer",
            "null"
          ]
        },
        "car_facilities": {
          "type": "array",
          "items": {
            "type": "object"
          }
        },
        "bike_facilities": {
          "type": "array",
          "items": {
            "type": "object"
          }
        }
      }
    },
    "ParkingOnStreetPayload": {
      "type": "object",
      "required": [
        "kind"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "parking_onstreet"
          ],
          "default": "parking_onstreet"
        },
        "segment_count": {
          "type": [
            "integer",
            "null"
          ]
        },
        "total_spaces": {
          "type": [
            "integer",
            "null"
          ]
        },
        "zone_count": {
          "type": [
            "integer",
            "null"
          ]
        },
        "accessible_bay_count": {
          "type": [
            "integer",
            "null"
          ]
        },
        "accessible_spaces": {
          "type": [
            "integer",
            "null"
          ]
        },
        "loading_zone_count": {
          "type": [
            "integer",
            "null"
          ]
        },
        "loading_spaces": {
          "type": [
            "integer",
            "null"
          ]
        },
        "by_regulation": {
          "type": "array",
          "items": {
            "type": "object"
          }
        },
        "by_street": {
          "type": "array",
          "items": {
            "type": "object"
          }
        },
        "zones": {
          "type": "array",
          "items": {
            "type": "object"
          }
        },
        "accessible_bays": {
          "type": "array",
          "items": {
            "type": "object"
          }
        },
        "loading_zones": {
          "type": "array",
          "items": {
            "type": "object"
          }
        }
      }
    },
    "ParkingPayload": {
      "type": "object",
      "required": [
        "kind"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "parking"
          ],
          "default": "parking"
        },
        "facilities": {
          "type": "array",
          "items": {
            "type": "object"
          }
        }
      }
    },
    "PoiPayload": {
      "type": "object",
      "required": [
        "kind",
        "poi_type",
        "count"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "poi"
          ],
          "default": "poi"
        },
        "poi_type": {
          "type": "string"
        },
        "count": {
          "type": "integer"
        },
        "total_available": {
          "type": [
            "integer",
            "null"
          ]
        },
        "truncated": {
          "type": "boolean",
          "default": false
        },
        "items": {
          "type": "array",
          "items": {
            "type": "object"
          }
        }
      }
    },
    "PollenUvPayload": {
      "type": "object",
      "required": [
        "kind"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "pollen_uv"
          ],
          "default": "pollen_uv"
        },
        "region_id": {
          "type": [
            "integer",
            "null"
          ]
        },
        "region_name": {
          "type": [
            "string",
            "null"
          ]
        },
        "pollen": {
          "type": "object"
        },
        "uv_index": {
          "type": [
            "number",
            "null"
          ]
        }
      }
    },
    "PopulationDensityPayload": {
      "type": "object",
      "required": [
        "kind"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "population_density"
          ],
          "default": "population_density"
        },
        "population": {
          "type": [
            "integer",
            "null"
          ]
        },
        "populated_cells": {
          "type": "integer",
          "default": 0
        },
        "populated_area_km2": {
          "type": [
            "number",
            "null"
          ]
        },
        "density_per_km2": {
          "type": [
            "number",
            "null"
          ]
        },
        "grid": {
          "type": "string"
        },
        "reference_year": {
          "type": "integer",
          "default": 2022
        }
      }
    },
    "PowerPayload": {
      "type": "object",
      "required": [
        "kind",
        "measure"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "power"
          ],
          "default": "power"
        },
        "measure": {
          "type": "string",
          "enum": [
            "load",
            "price"
          ]
        },
        "value": {
          "type": [
            "number",
            "null"
          ]
        },
        "unit": {
          "type": [
            "string",
            "null"
          ]
        },
        "region": {
          "type": [
            "string",
            "null"
          ]
        },
        "series_date": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    },
    "PublicTenderPayload": {
      "type": "object",
      "required": [
        "kind",
        "notice_id",
        "notice_version"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "public_tender"
          ],
          "default": "public_tender"
        },
        "notice_id": {
          "type": "string"
        },
        "notice_version": {
          "type": "string"
        },
        "release_id": {
          "type": [
            "string",
            "null"
          ]
        },
        "notice_type": {
          "type": [
            "string",
            "null"
          ]
        },
        "status": {
          "type": [
            "string",
            "null"
          ]
        },
        "award_status": {
          "type": [
            "string",
            "null"
          ]
        },
        "title": {
          "type": [
            "string",
            "null"
          ]
        },
        "buyer_name": {
          "type": [
            "string",
            "null"
          ]
        },
        "buyer_city": {
          "type": [
            "string",
            "null"
          ]
        },
        "buyer_postal_code": {
          "type": [
            "string",
            "null"
          ]
        },
        "nuts": {
          "type": [
            "string",
            "null"
          ]
        },
        "cpv": {
          "type": [
            "string",
            "null"
          ]
        },
        "value": {
          "type": [
            "number",
            "null"
          ]
        },
        "currency": {
          "type": [
            "string",
            "null"
          ]
        },
        "publication_date": {
          "type": [
            "string",
            "null"
          ]
        },
        "deadline": {
          "type": [
            "string",
            "null"
          ]
        },
        "award_date": {
          "type": [
            "string",
            "null"
          ]
        },
        "suppliers": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "award_value": {
          "type": [
            "number",
            "null"
          ]
        },
        "award_currency": {
          "type": [
            "string",
            "null"
          ]
        },
        "match": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "source_url": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    },
    "RegionalStatPayload": {
      "type": "object",
      "required": [
        "kind",
        "dataset"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "regional_stat"
          ],
          "default": "regional_stat"
        },
        "dataset": {
          "type": "string"
        },
        "reference_year": {
          "type": [
            "integer",
            "null"
          ]
        },
        "region_name": {
          "type": [
            "string",
            "null"
          ]
        },
        "values": {
          "type": "object"
        }
      }
    },
    "RoadEventPayload": {
      "type": "object",
      "required": [
        "kind"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "road_event"
          ],
          "default": "road_event"
        },
        "city_source": {
          "type": [
            "string",
            "null"
          ]
        },
        "events": {
          "type": "array",
          "items": {
            "type": "object"
          }
        }
      }
    },
    "SharingPayload": {
      "type": "object",
      "required": [
        "kind"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "sharing"
          ],
          "default": "sharing"
        },
        "radius_km": {
          "type": [
            "number",
            "null"
          ]
        },
        "vehicles_available": {
          "type": "integer",
          "default": 0
        },
        "free_floating_available": {
          "type": "integer",
          "default": 0
        },
        "docked_available": {
          "type": "integer",
          "default": 0
        },
        "station_count": {
          "type": "integer",
          "default": 0
        },
        "providers": {
          "type": "array",
          "items": {
            "type": "object"
          }
        }
      }
    },
    "SolarPayload": {
      "type": "object",
      "required": [
        "kind"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "solar"
          ],
          "default": "solar"
        },
        "annual_irradiation_kwh_m2": {
          "type": [
            "number",
            "null"
          ]
        },
        "annual_yield_kwh_kwp": {
          "type": [
            "number",
            "null"
          ]
        },
        "optimal_slope_deg": {
          "type": [
            "number",
            "null"
          ]
        },
        "optimal_azimuth_deg": {
          "type": [
            "number",
            "null"
          ]
        },
        "peakpower_kwp": {
          "type": [
            "number",
            "null"
          ]
        },
        "system_loss_pct": {
          "type": [
            "number",
            "null"
          ]
        },
        "total_performance_delta_pct": {
          "type": [
            "number",
            "null"
          ]
        },
        "radiation_db": {
          "type": [
            "string",
            "null"
          ]
        },
        "period_start": {
          "type": [
            "integer",
            "null"
          ]
        },
        "period_end": {
          "type": [
            "integer",
            "null"
          ]
        },
        "monthly": {
          "type": "array",
          "items": {
            "type": "object"
          }
        }
      }
    },
    "SolarRoofsPayload": {
      "type": "object",
      "required": [
        "kind"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "solar_roofs"
          ],
          "default": "solar_roofs"
        },
        "potential_kwp": {
          "type": [
            "number",
            "null"
          ]
        },
        "potential_yield_mwh": {
          "type": [
            "number",
            "null"
          ]
        },
        "installed_kwp": {
          "type": [
            "number",
            "null"
          ]
        },
        "installed_yield_mwh": {
          "type": [
            "number",
            "null"
          ]
        },
        "exploitation_pct": {
          "type": [
            "number",
            "null"
          ]
        },
        "potential_by_category": {
          "type": "object"
        },
        "reference_date": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    },
    "StationArrivalsPayload": {
      "type": "object",
      "required": [
        "kind"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "station_arrivals"
          ],
          "default": "station_arrivals"
        },
        "arrival_count": {
          "type": "integer",
          "default": 0
        },
        "long_distance_count": {
          "type": "integer",
          "default": 0
        },
        "arrivals": {
          "type": "array",
          "items": {
            "type": "object"
          }
        }
      }
    },
    "StationCatalogPayload": {
      "type": "object",
      "required": [
        "kind"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "station_catalog"
          ],
          "default": "station_catalog"
        },
        "station_count": {
          "type": "integer",
          "default": 0
        },
        "stations": {
          "type": "array",
          "items": {
            "type": "object"
          }
        }
      }
    },
    "StationDeparturesPayload": {
      "type": "object",
      "required": [
        "kind"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "station_departures"
          ],
          "default": "station_departures"
        },
        "departure_count": {
          "type": "integer",
          "default": 0
        },
        "long_distance_count": {
          "type": "integer",
          "default": 0
        },
        "departures": {
          "type": "array",
          "items": {
            "type": "object"
          }
        }
      }
    },
    "StationFacilityPayload": {
      "type": "object",
      "required": [
        "kind"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "station_facilities"
          ],
          "default": "station_facilities"
        },
        "count": {
          "type": "integer",
          "default": 0
        },
        "counts": {
          "type": "object"
        },
        "facilities": {
          "type": "array",
          "items": {
            "type": "object"
          }
        },
        "truncated": {
          "type": "boolean",
          "default": false
        }
      }
    },
    "TaxRatesPayload": {
      "type": "object",
      "required": [
        "kind"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "tax_rates"
          ],
          "default": "tax_rates"
        },
        "trade_tax_rate": {
          "type": [
            "integer",
            "null"
          ]
        },
        "property_tax_a": {
          "type": [
            "integer",
            "null"
          ]
        },
        "property_tax_b": {
          "type": [
            "integer",
            "null"
          ]
        },
        "property_tax_c": {
          "type": [
            "integer",
            "null"
          ]
        },
        "reference_date": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    },
    "TrafficEventPayload": {
      "type": "object",
      "required": [
        "kind"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "traffic_event"
          ],
          "default": "traffic_event"
        },
        "station_id": {
          "type": [
            "string",
            "null"
          ]
        },
        "roadworks": {
          "type": "array",
          "items": {
            "type": "object"
          }
        },
        "warnings": {
          "type": "array",
          "items": {
            "type": "object"
          }
        },
        "roadworks_total": {
          "type": [
            "integer",
            "null"
          ]
        },
        "roadworks_truncated": {
          "type": "boolean",
          "default": false
        },
        "congestion_summary": {
          "type": [
            "object",
            "null"
          ]
        }
      }
    },
    "TrafficFlowPayload": {
      "type": "object",
      "required": [
        "kind"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "traffic_flow"
          ],
          "default": "traffic_flow"
        },
        "station_id": {
          "type": [
            "string",
            "null"
          ]
        },
        "measurements": {
          "type": "array",
          "items": {
            "type": "object"
          }
        },
        "summary": {
          "type": [
            "object",
            "null"
          ]
        }
      }
    },
    "TransitDeparturePayload": {
      "type": "object",
      "required": [
        "kind"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "transit_departure"
          ],
          "default": "transit_departure"
        },
        "stop_id": {
          "type": [
            "string",
            "null"
          ]
        },
        "departures": {
          "type": "array",
          "items": {
            "type": "object"
          }
        }
      }
    },
    "TransitRouteStatusPayload": {
      "type": "object",
      "required": [
        "kind"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "transit_route_status"
          ],
          "default": "transit_route_status"
        },
        "route_id": {
          "type": [
            "string",
            "null"
          ]
        },
        "active_trips": {
          "type": "integer",
          "default": 0
        },
        "avg_delay_s": {
          "type": [
            "number",
            "null"
          ]
        },
        "max_delay_s": {
          "type": [
            "integer",
            "null"
          ]
        },
        "trips": {
          "type": "array",
          "items": {
            "type": "object"
          }
        }
      }
    },
    "TransitStopPayload": {
      "type": "object",
      "required": [
        "kind",
        "stop_id",
        "stop_name"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "transit_stop"
          ],
          "default": "transit_stop"
        },
        "stop_id": {
          "type": "string"
        },
        "stop_name": {
          "type": "string"
        },
        "location_type": {
          "type": [
            "integer",
            "null"
          ]
        },
        "parent_station": {
          "type": [
            "string",
            "null"
          ]
        },
        "platform_code": {
          "type": [
            "string",
            "null"
          ]
        },
        "wheelchair_boarding": {
          "type": [
            "integer",
            "null"
          ]
        }
      }
    },
    "TransitTripPayload": {
      "type": "object",
      "required": [
        "kind",
        "trip_id"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "transit_trip"
          ],
          "default": "transit_trip"
        },
        "trip_id": {
          "type": "string"
        },
        "route_id": {
          "type": [
            "string",
            "null"
          ]
        },
        "delay_s": {
          "type": [
            "integer",
            "null"
          ]
        },
        "estimated_position": {
          "type": [
            "object",
            "null"
          ]
        },
        "stop_time_updates": {
          "type": "array",
          "items": {
            "type": "object"
          }
        },
        "unresolved": {
          "type": "boolean",
          "default": false
        }
      }
    },
    "VehicleRegistrationPayload": {
      "type": "object",
      "required": [
        "kind"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "vehicle_registration"
          ],
          "default": "vehicle_registration"
        },
        "pkw_total": {
          "type": [
            "integer",
            "null"
          ]
        },
        "electric_share": {
          "type": [
            "number",
            "null"
          ]
        },
        "bev_share": {
          "type": [
            "number",
            "null"
          ]
        },
        "plugin_hybrid_share": {
          "type": [
            "number",
            "null"
          ]
        },
        "bev_estimated": {
          "type": [
            "integer",
            "null"
          ]
        },
        "district": {
          "type": [
            "string",
            "null"
          ]
        },
        "district_key": {
          "type": [
            "string",
            "null"
          ]
        },
        "reference_period": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    },
    "WaterLevelPayload": {
      "type": "object",
      "required": [
        "kind"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "water_level"
          ],
          "default": "water_level"
        },
        "station": {
          "type": [
            "string",
            "null"
          ]
        },
        "water": {
          "type": [
            "string",
            "null"
          ]
        },
        "value": {
          "type": [
            "number",
            "null"
          ]
        },
        "unit": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    },
    "WeatherPayload": {
      "type": "object",
      "required": [
        "kind"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "weather"
          ],
          "default": "weather"
        },
        "station_id": {
          "type": [
            "string",
            "null"
          ]
        },
        "temperature_c": {
          "type": [
            "number",
            "null"
          ]
        },
        "humidity": {
          "type": [
            "number",
            "null"
          ]
        },
        "wind_speed": {
          "type": [
            "number",
            "null"
          ]
        },
        "condition": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    },
    "WeatherWarningPayload": {
      "type": "object",
      "required": [
        "kind"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "weather_warning"
          ],
          "default": "weather_warning"
        },
        "count": {
          "type": "integer",
          "default": 0
        },
        "max_level": {
          "type": [
            "integer",
            "null"
          ]
        },
        "warnings": {
          "type": "array",
          "items": {
            "type": "object"
          }
        },
        "special_warnings": {
          "type": "array",
          "items": {
            "type": "object"
          }
        }
      }
    }
  }
}