{
  "compiled_at": "2026-10-29T06:39:10.742753+00:00",
  "country": "DE",
  "geographical_postcodes": 8159,
  "with_source_coordinates": 8159,
  "pending_coordinates": 0,
  "stadia_confirmed_coordinates": 17,
  "states": [
    "Baden-Württemberg",
    "Bayern",
    "Berlin",
    "Brandenburg",
    "Bremen",
    "Hamburg",
    "Hessen",
    "Mecklenburg-Vorpommern",
    "Niedersachsen",
    "Nordrhein-Westfalen",
    "Rheinland-Pfalz",
    "Saarland",
    "Sachsen",
    "Sachsen-Anhalt",
    "Schleswig-Holstein",
    "Thüringen"
  ],
  "sources": [
    {
      "name": "GeoNames postal-code extract DE",
      "url": "https://download.geonames.org/export/zip/DE.zip",
      "documentation": "https://download.geonames.org/export/zip/readme.txt",
      "license": "CC BY 4.0",
      "license_url": "https://creativecommons.org/licenses/by/4.0/",
      "attribution": "GeoNames",
      "raw_sha256": "c7e24987376e6a516f114b63b30704956474128f44cfd2b1bceada036a0947cc",
      "raw_rows": 23297
    },
    {
      "name": "OpenPLZ API German streets from OSM postcode areas",
      "url": "https://raw.githubusercontent.com/openpotato/openplzapi.data/main/src/de/osm/streets.updated.csv",
      "documentation": "https://github.com/openpotato/openplzapi.data",
      "license": "ODbL 1.0",
      "license_url": "https://opendatacommons.org/licenses/odbl/1-0/",
      "attribution": "OpenPLZ API / OpenStreetMap contributors",
      "raw_sha256": "1066a96a6b3a16629a94c834fca49fe58a2bb01558e17242c53a12d68b290088",
      "raw_rows": 1201689,
      "dataset_version": {
        "commit": "c26389b30573ab2738d0b14fd350f143aa0a1251",
        "committed_at": "2025-11-22T13:09:29Z",
        "url": "https://github.com/openpotato/openplzapi.data/commit/c26389b30573ab2738d0b14fd350f143aa0a1251"
      }
    }
  ],
  "derived_database_license": "ODbL 1.0; GeoNames attribution retained under CC BY 4.0",
  "transformations": [
    "Geographical eligibility from OpenPLZ OSM postcode-area street membership.",
    "GeoNames corporate/special-delivery records excluded; German state names normalized.",
    "One record per postcode. All source place names, represented states and municipalities retained.",
    "Representative coordinate selected from actual source points, not a boundary or exact address.",
    "Locally stored, provider-confirmed Stadia postal-code points override general source points. Remaining missing coordinates stay pending."
  ],
  "limitations": [
    "Open datasets, not an official Deutsche Post completeness guarantee.",
    "GeoNames coordinates can be estimated and do not represent every address within the postcode.",
    "Postcode and municipality boundaries need not coincide; a code can include multiple municipalities or states.",
    "No station coverage, prices, search volumes or ranking difficulty inferred from postal geography."
  ],
  "coordinate_providers": {
    "GeoNames": 8142,
    "Stadia Maps Geocoding": 17
  },
  "download_headers": {
    "DE.zip": {
      "last_modified": "Thu, 29 Oct 2026 03:02:47 GMT",
      "size": 384018
    },
    "readme.txt": {
      "last_modified": "Thu, 29 Oct 2026 03:02:29 GMT",
      "size": 2893
    }
  }
}
