{"id":"8f5b1385-0c69-4c63-9902-e8a8027cd75b","type":"API","name":"Official index of cities and towns including postal codes and perimeter","slug":"official-index-of-cities-and-towns-including-postal-codes-and-perimeter","description":"In Article 24 of the regulations governing geographic names (GeoNV), the Federal Office of Topography (swisstopo) is commissioned to establish, administer and publish the new official index of cities and towns including postal codes and perimeter. The data are stored centrally at swisstopo.The data…","free_access_class":"FREE_NO_AUTH","auth_type":"NONE","homepage_url":"http://data.europa.eu/88u/dataset/972cd117-f1ed-4818-be14-233d89ab9fdf-bundesamt-fur-landestopografie-swisstopo","docs_url":"http://data.europa.eu/88u/dataset/972cd117-f1ed-4818-be14-233d89ab9fdf-bundesamt-fur-landestopografie-swisstopo","repo_url":null,"status":"ACTIVE","verification_state":"VERIFIED","tags":["geospatial","boundaries"],"logo_url":"data:image/x-icon;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAAGXRFWHRTb2Z0d2FyZQBBZG9iZSBJbWFnZVJlYWR5ccllPAAAAjJJREFUeNpi/P//P8NAAiaGAQajDhhwB7Cw+C86MKAOAGL7IRsF+vKPGOw1b9DXAfkeO+GWz0+bzTAPiP2Nz6LI0cwBfTFLGXqjl4Hpiw/lGD584wKLbzxrzFAXtJ6hLnA92EECXN9ISgMEAchAkGUgSy89kgPTIJA0MxXFEQ7A6ADxQVhB5A3DgzciBM1mZPZb+J9QPMfbHmZ4CDRs/1UthkuPZeEOwuZIPdnHDIpirxji7Y4wNK4LhDuWoijwNz7HkOe+i+HTd04wH91yZLFHb4XBlvsZnQOGwmvKowDkg41njcAWEBOkIHUHr2uA8YM3otSJAphDSAWgqFt42BavGmYm9cAG3EF/Fpiq5zB46F1mePGRn+HmcymiLAYlwH3V7QzhFicYONh+A0NDk7w0AErZH6GpGsQmFoCi6gI4m3IzLDpkS1kUgHwDM5QUANIHS5jYEi3RuQBksb3mdXhaILbcyAOWirAygaJcAEoHoJIPBJzaqggmRpDloPjXk3sEVksoERJ0ACjuD944As8JoMoHlMVw5RiQmgNAeVAauPBInvJsiAxA5X287RGgr2wYmoClHMi3IAyKJlBFBCqsQHKTdrgTDHqS6gIYePhahEEemLhAOQPk23z3nQwKom8YJu5wY3gAlcNWTFPNAaCSTaWwl0EeaCkoqEGW68s9BOdzkMXGNc0k1YQkRwE6sIfWfqCQIcXXZIcAOsCVGEl1wMGBbBMyjnbNRh0w0A4ACDAADLUDJHo7TiUAAAAASUVORK5CYII=","primary_source_url":"https://api3.geo.admin.ch/rest/services/api/MapServer/ch.swisstopo-vd.ortschaftenverzeichnis_plz","extraction_confidence":"0.40","created_at":"2026-06-27T02:32:00.175Z","updated_at":"2026-08-14T19:32:11.226Z","last_verified_at":"2026-08-14T19:32:11.226Z","deprecated_at":null,"ranking_score":52,"last_ranked_at":"2026-08-09T20:04:52.225Z","last_seen_at":null,"last_validated_at":null,"last_uptime_at":"2026-08-04T17:53:21.744Z","search_vector":"'24':14B,77B,158B,221B 'a':270B 'across':114B,258B 'administ':32B 'administer':176B 'administr':130B 'administrative':274B 'and':149A,154A,177B,185B,190B,209B,215B,251B,256B,276B,282B 'applic':134B 'applications':278B 'are':194B 'area':141B,285B 'articl':13B,76B 'article':157B,220B 'as':269B 'at':197B 'authorit':105B 'authoritative':249B 'behalf':97B,241B 'boundari':106B,144C 'boundary':250B 'by':233B 'cartograph':131B 'cartographic':275B 'central':52B,88B 'centrally':196B,232B 'citi':4A,40B,64B 'cities':148A,184B,208B 'code':9A,45B,70B 'codes':153A,189B,214B 'commiss':29B 'commissioned':173B 'confeder':101B 'confederation':245B 'consist':117B 'consistent':261B 'data':49B,55B,142B,193B,199B,286B 'dataset':57B,201B 'establish':31B,74B,175B 'established':218B 'feder':23B,91B 'federal':167B,235B 'for':254B,273B 'geograph':19B,72B,82B 'geographic':163B,216B,226B 'geonv':21B,84B,165B,228B 'geospati':133B,143C 'geospatial':277B 'govern':18B,81B 'governing':162B,225B 'identif':118B 'identification':262B 'in':156B 'includ':7A,43B,67B 'including':151A,187B,211B 'index':2A,38B,62B,146A,182B,206B 'inform':109B 'information':253B 'is':172B,202B,230B 'it':229B,267B 'local':113B 'localities':257B 'maintain':87B 'maintained':231B 'municip':111B,137B 'municipal':281B 'municipalities':255B 'name':20B,83B,121B 'names':164B,227B,265B 'nationwid':122B 'nationwide':266B 'new':36B,180B 'of':147A,159B,169B,183B,207B,222B,237B,242B,263B 'offic':24B,92B 'office':168B,236B 'offici':1A,37B,60B 'official':145A,181B,204B 'on':240B 'perimet':11A,47B,73B 'perimeter':155A,191B 'perimeters':217B 'place':120B,264B 'postal':8A,44B,69B,108B,140B,152A,188B,213B,252B,284B 'postal-area':139B,283B 'provid':104B 'provides':248B 'publish':34B,178B 'refer':127B 'reference':271B 'regist':103B 'register':247B 'regul':17B,80B 'regulations':161B,224B 'requir':135B 'requiring':279B 'serv':124B 'serves':268B 'sourc':128B 'source':272B 'standard':136B 'standardized':280B 'store':51B 'stored':195B 'support':116B 'supporting':260B 'swiss':61B,100B,205B,244B 'swisstopo':27B,95B,171B,239B 'swisstopo.the':54B,198B 'switzerland':115B,259B 'the':160B,166B,179B,192B,203B,223B,234B,243B,246B 'their':212B 'this':200B 'to':174B 'topographi':26B,94B 'topography':170B,238B 'town':6A,42B,66B 'towns':150A,186B,210B 'under':219B","popularity_score":"0.0000","maintenance_score":"0.7000","institution_id":"e6610aa1-093d-4dd5-9dea-b71951ae3eb2","institution_type":"GOVERNMENT","country_code":"CH","official_confidence":40,"proof_summary":"40% - Official domain (admin.ch)","source_seed_url":null,"is_public_sector":true,"published_at":"2026-06-27T07:31:31.938Z","geographic_scope":"NATIONAL","name_en":null,"description_en":"This dataset is the official Swiss index of cities and towns, including their postal codes and geographic perimeters. Established under Article 24 of the regulations governing geographic names (GeoNV), it is maintained centrally by the Federal Office of Topography (swisstopo) on behalf of the Swiss Confederation. The register provides authoritative boundary and postal information for municipalities and localities across Switzerland, supporting consistent identification of place names nationwide. It serves as a reference source for administrative, cartographic, and geospatial applications requiring standardized municipal and postal-area data.","native_lang":"en","access_level":"direct","formats":[],"capability_tier":"sample","trust_score":61.75,"access":{"level":"direct","primary":{"kind":"query","label":"Run verified request","method":"GET","url":"https://api3.geo.admin.ch/rest/services/api/MapServer/ch.swisstopo-vd.ortschaftenverzeichnis_plz","source":"probe","runnable":true},"actions":[{"kind":"query","label":"Run verified request","method":"GET","url":"https://api3.geo.admin.ch/rest/services/api/MapServer/ch.swisstopo-vd.ortschaftenverzeichnis_plz","source":"probe","runnable":true},{"kind":"query","label":"Layer metadata","method":"GET","url":"https://api3.geo.admin.ch/rest/services/api/MapServer/ch.swisstopo-vd.ortschaftenverzeichnis_plz?f=json","source":"query_example","runnable":true,"direct":false},{"kind":"landing","label":"Read the docs","method":"GET","url":"http://data.europa.eu/88u/dataset/972cd117-f1ed-4818-be14-233d89ab9fdf-bundesamt-fur-landestopografie-swisstopo","source":"docs","runnable":false}],"formats":[]},"maturity":{"entry_id":"8f5b1385-0c69-4c63-9902-e8a8027cd75b","granularity":"entry","granularity_label":"One unit = one catalog entry. A PROXY for the SCOPE.md §4 ladder, which governs source families, not entries: a family with 400 entries moves this reading 400 times as much as a family with one. Never compare or combine with the source_family reading.","level":"profiled","level_index":3,"level_label":"Profiled","meaning":"Schema, dimensions and licence understood","counts_as_coverage":false,"blocked_by":null,"rungs":[{"level":"discovered","level_index":1,"label":"Discovered","meaning":"Source and metadata recorded","evidence":"membership of the named population the ladder is taken over","counts_as_coverage":false,"met":true,"reached":true,"criterion":"TRUE"},{"level":"verified","level_index":2,"label":"Verified","meaning":"Access tested successfully","evidence":"entries.verification_state = 'VERIFIED'","counts_as_coverage":false,"met":true,"reached":true,"criterion":"entries.verification_state = 'VERIFIED'"},{"level":"profiled","level_index":3,"label":"Profiled","meaning":"Schema, dimensions and licence understood","evidence":"a data profile with at least one field (entry_data_profiles.field_count > 0)","counts_as_coverage":false,"met":true,"reached":true,"criterion":"EXISTS (SELECT 1 FROM entry_data_profiles p WHERE p.entry_id = entries.id AND COALESCE(p.field_count, 0) > 0)"},{"level":"executable","level_index":4,"label":"Executable","meaning":"Queries run through Commodity","evidence":"entries.capability_tier = 'live' — today's proxy for \"queryable through us\"","counts_as_coverage":true,"met":false,"reached":false,"criterion":"entries.capability_tier = 'live'"},{"level":"joinable","level_index":5,"label":"Joinable","meaning":"Canonical identifiers and concepts mapped","evidence":"a field link to a canonical identifier whose sampled VALUES match its format","counts_as_coverage":true,"met":false,"reached":false,"criterion":"EXISTS (SELECT 1 FROM entry_field_links efl WHERE efl.entry_id = entries.id AND efl.identifier_id IS NOT NULL AND efl.value_status = 'match')"},{"level":"reproducible","level_index":6,"label":"Reproducible","meaning":"Snapshots and transformation evidence retained","evidence":"at least one retained evidence manifest (migration 078)","counts_as_coverage":true,"met":false,"reached":false,"criterion":"EXISTS (SELECT 1 FROM evidence_manifests em WHERE em.entry_id = entries.id)"},{"level":"guaranteed","level_index":7,"label":"Guaranteed","meaning":"Monitored against an operational reliability target","evidence":"an active reliability target with a named monitor (migration 096)","counts_as_coverage":true,"met":false,"reached":false,"criterion":"EXISTS (SELECT 1 FROM entry_reliability_targets rt WHERE rt.entry_id = entries.id AND rt.is_active = true)"}],"officialness":{"basis":"catalog_inherited","label":"Inherited from the upstream catalog: this item came from a trusted official government catalog, and that provenance — not per-item proof — is the warrant. Its own proof score is below 80 or it matched no registered institution (apps/worker/src/connectors/catalog/qualify-store.ts).","proof_confidence":40,"proven_threshold":80,"institution_id":"e6610aa1-093d-4dd5-9dea-b71951ae3eb2","definition":"CASE WHEN COALESCE(entries.is_public_sector, false) IS NOT TRUE THEN 'not_official' WHEN COALESCE(entries.official_confidence, 0) >= 80 AND entries.institution_id IS NOT NULL THEN 'per_item_proven' ELSE 'catalog_inherited' END"},"source_family":{"key":"api3.geo.admin.ch","label":"One unit = one source family, approximated by the serving host of the entry's primary source URL (e.g. bdl.stat.gov.pl). A COMPUTED stand-in for the curated families of SCOPE.md §5, which no table holds yet. A family sits at the highest level any of its entries has reached, because a family is integrated to the depth of its deepest working integration. Never compare or combine with the entry reading."},"generated_at":"2026-08-16T16:17:07.284Z"},"api_details":{"id":"120fc063-4d63-4153-af40-746eb64f402e","entry_id":"8f5b1385-0c69-4c63-9902-e8a8027cd75b","base_url":"https://api3.geo.admin.ch/rest/services/api/MapServer/ch.swisstopo-vd.ortschaftenverzeichnis_plz","openapi_url":null,"graphql_url":null,"api_version":null,"spec_format":null,"endpoints_count":null,"endpoints":[],"rate_limit_info":null,"free_tier_limits":null,"ping_url":"https://api3.geo.admin.ch/rest/services/api/MapServer/ch.swisstopo-vd.ortschaftenverzeichnis_plz","created_at":"2026-06-27T02:32:00.341Z","updated_at":"2026-06-27T02:32:00.341Z"},"dataset_details":null,"license":null,"reuse":{"license_id":null,"license_name":null,"license_url":null,"commercial_use":{"status":"unknown","value":null},"redistribution":{"status":"unknown","value":null},"attribution_required":{"status":"unknown","value":null},"share_alike":{"status":"unknown","value":null},"personal_data_warning":{"status":"unknown","value":null},"cache_and_mirror":{"status":"unknown","value":null},"undetermined":["commercial_use","redistribution","attribution_required","share_alike","personal_data_warning","cache_and_mirror"],"basis":"unverified","confidence":0.1,"confidence_tier":"low","source_text":null,"source_url":null,"reviewed_at":null},"license_raw":null,"latest_check":{"id":"b9273dc7-af27-4c98-bfb5-8c3dbf98bb20","entry_id":"8f5b1385-0c69-4c63-9902-e8a8027cd75b","status":"VERIFIED","last_checked_at":"2026-08-14T19:32:10.938Z","p50_latency_ms":918,"p95_latency_ms":null,"last_error":null,"consecutive_failures":0,"created_at":"2026-06-27T03:28:44.800Z","updated_at":"2026-08-14T19:32:10.938Z","consecutive_successes":55,"probe_url":"https://api3.geo.admin.ch/rest/services/api/MapServer/ch.swisstopo-vd.ortschaftenverzeichnis_plz","probe_method":"GET","probe_http_status":200,"probe_content_type":"application/json","probe_succeeded_at":"2026-08-14T19:32:10.938Z"},"data_profile":{"id":"ec43f73f-639f-4927-94b3-75c834f3c3b1","entry_id":"8f5b1385-0c69-4c63-9902-e8a8027cd75b","profile_source":"arcgis","profile_kind":"dataset","dataset_id":null,"fields":[{"name":"bgdi_created","type":"varchar","label":"ch.swisstopo-vd.ortschaftenverzeichnis_plz.bgdi_created","description":null,"description_en":"Timestamp when the record was created in the BGDI system."},{"name":"langtext","type":"varchar","label":"Location","description":null,"description_en":"Official name of the city or town."},{"name":"zusziff","type":"varchar","label":"Additional Number","description":null,"description_en":"Additional digit used to distinguish postal codes with the same PLZ."},{"name":"plz","type":"integer","label":"ZIP4","description":null,"description_en":"Four-digit Swiss postal code for the locality."},{"name":"modified","type":"datetime","label":"Last modification","description":null,"description_en":"Date and time of the last update to the record."},{"name":"id","type":"varchar","label":"ch.swisstopo-vd.ortschaftenverzeichnis_plz.id","description":null,"description_en":"Unique identifier of the postal code record."},{"name":"status","type":"varchar","label":"Status","description":null,"description_en":"Current status of the postal code entry."}],"field_count":7,"sample_records":[],"record_count":null,"data_size_bytes":null,"dataset_count":null,"query_examples":[{"url":"https://api3.geo.admin.ch/rest/services/api/MapServer/ch.swisstopo-vd.ortschaftenverzeichnis_plz?f=json","curl":"curl -s 'https://api3.geo.admin.ch/rest/services/api/MapServer/ch.swisstopo-vd.ortschaftenverzeichnis_plz?f=json' -H 'Accept: application/json'","label":"Layer metadata","method":"GET","description":"Layer definition: fields, geometry type, capabilities."}],"status":"ok","error_message":null,"profiled_at":"2026-07-26T11:31:55.920Z","run_id":"21bd8a8c-7a59-4913-8313-fdff1dfc4768","created_at":"2026-06-27T02:33:45.268Z","updated_at":"2026-07-26T11:31:55.920Z","license_raw":null,"license_id":null,"consecutive_failure_count":0,"last_error_at":null,"last_error_message":null,"previewable":false},"datasets":[],"limits":[]}