{
 "meta": {
  "api_version": "1.4.1",
  "generated": "2026-10-04",
  "notice": "Screening-level results from terrain, inventory and index-map evidence only. Natural hazards are read from federal index maps, not assessed on site; geology is not assessed. Not a basis for engineering or investment decisions without a feasibility study.",
  "docs": "https://gopalinternship-unibasel.github.io/basinscope-alps/api/"
 },
 "data": {
  "name": "BasinScope Alps data API",
  "study_area": "Jungfrau-Aletsch, 781 km2, Bernese and Valais Alps",
  "base_url": "https://gopalinternship-unibasel.github.io/basinscope-alps/api/v1",
  "endpoints": [
   {
    "path": "/sites.json",
    "url": "https://gopalinternship-unibasel.github.io/basinscope-alps/api/v1/sites.json",
    "description": "The 15 ranked basin sites: location, basin volume, dam length, glacier area upstream, protection, illustrative investment."
   },
   {
    "path": "/sites/{id}.json",
    "url": "https://gopalinternship-unibasel.github.io/basinscope-alps/api/v1/sites/{id}.json",
    "description": "One site by id (1 to 15, its rank in the terrain analysis report)."
   },
   {
    "path": "/sites.geojson",
    "url": "https://gopalinternship-unibasel.github.io/basinscope-alps/api/v1/sites.geojson",
    "description": "The same sites as a GeoJSON FeatureCollection in WGS84, for GIS and web maps."
   },
   {
    "path": "/candidates.json",
    "url": "https://gopalinternship-unibasel.github.io/basinscope-alps/api/v1/candidates.json",
    "description": "The 28 further candidate points that did not make the shortlist, with their protection check."
   },
   {
    "path": "/catchments.json",
    "url": "https://gopalinternship-unibasel.github.io/basinscope-alps/api/v1/catchments.json",
    "description": "The 9 Hydro-CH2018 catchments the sites are matched to."
   },
   {
    "path": "/catchments/{id}.json",
    "url": "https://gopalinternship-unibasel.github.io/basinscope-alps/api/v1/catchments/{id}.json",
    "description": "One catchment with monthly runoff for RCP2.6, 4.5 and 8.5 in the reference period, 2035, 2060 and 2085 (median, minimum, maximum of the model ensemble)."
   },
   {
    "path": "/glaciers.json",
    "url": "https://gopalinternship-unibasel.github.io/basinscope-alps/api/v1/glaciers.json",
    "description": "The ten largest glaciers of the study area."
   },
   {
    "path": "/exits.json",
    "url": "https://gopalinternship-unibasel.github.io/basinscope-alps/api/v1/exits.json",
    "description": "Where meltwater leaves the study area, with the glacier area behind each exit."
   },
   {
    "path": "/elevation-bands.json",
    "url": "https://gopalinternship-unibasel.github.io/basinscope-alps/api/v1/elevation-bands.json",
    "description": "Land and glacier area by 500 m elevation band."
   },
   {
    "path": "/hydropower-plants.json",
    "url": "https://gopalinternship-unibasel.github.io/basinscope-alps/api/v1/hydropower-plants.json",
    "description": "The 127 hydropower plants of 300 kW or more in the map extent: type, status, turbine power, expected yearly production (SFOE)."
   },
   {
    "path": "/dams.json",
    "url": "https://gopalinternship-unibasel.github.io/basinscope-alps/api/v1/dams.json",
    "description": "The 33 dams under federal supervision in the map extent: type, height, crest length, reservoir volume (SFOE)."
   },
   {
    "path": "/reservoir-storage.json",
    "url": "https://gopalinternship-unibasel.github.io/basinscope-alps/api/v1/reservoir-storage.json",
    "description": "Energy held in Swiss reservoirs, latest week and the past year, with the capacity (SFOE)."
   },
   {
    "path": "/grid.json",
    "url": "https://gopalinternship-unibasel.github.io/basinscope-alps/api/v1/grid.json",
    "description": "Swiss grid records: mean production by source, consumption and net import per calendar month, hydropower output per year against precipitation, net import per winter, filling of the storage lakes by week since 2000, and the plants matched to each catchment."
   },
   {
    "path": "/glacier-path.json",
    "url": "https://gopalinternship-unibasel.github.io/basinscope-alps/api/v1/glacier-path.json",
    "description": "Glacier area by year to 2100 as a share of today's, for RCP2.6, 4.5 and 8.5, from a published glacier model (Alps-wide)."
   },
   {
    "path": "/risk-hindcast.json",
    "url": "https://gopalinternship-unibasel.github.io/basinscope-alps/api/v1/risk-hindcast.json",
    "description": "What the risk outlook works with, for every day since March 2021: zero-degree level, precipitation, rain at each site, and the documented events the rule is tested against."
   },
   {
    "path": "/infrastructure-hazards.json",
    "url": "https://gopalinternship-unibasel.github.io/basinscope-alps/api/v1/infrastructure-hazards.json",
    "description": "Hazard process areas mapped around the hydropower plants of the stress test and the dams near the ranked sites, with their ground height."
   },
   {
    "path": "/federal-report.json",
    "url": "https://gopalinternship-unibasel.github.io/basinscope-alps/api/v1/federal-report.json",
    "description": "The projects of the 2024 Federal Council report on hydropower from glacier melt that lie in the study area, with the report's figures and the ranked site each one matches."
   },
   {
    "path": "/satellite.json",
    "url": "https://gopalinternship-unibasel.github.io/basinscope-alps/api/v1/satellite.json",
    "description": "Snow and ice left in the study area at the end of each summer since 2015 (Sentinel-2), the two scenes behind the then/now pictures, and glacier thinning measured from space for 2000 to 2019."
   },
   {
    "path": "/openapi.json",
    "url": "https://gopalinternship-unibasel.github.io/basinscope-alps/api/v1/openapi.json",
    "description": "OpenAPI 3.0 description of this API."
   }
  ],
  "sources": [
   {
    "what": "Sites, volumes, dam lengths, glacier areas",
    "source": "Team terrain analysis on swissALTI3D (swisstopo) and the Swiss Glacier Inventory SGI 2016 (GLAMOS)",
    "as_of": "2026-10-02"
   },
   {
    "what": "Monthly runoff scenarios",
    "source": "Hydro-CH2018, data set L03, Federal Office for the Environment (FOEN)"
   },
   {
    "what": "Protected areas",
    "source": "Federal inventories (FOEN, SFOE) through api3.geo.admin.ch, for a square reaching 250 m from each point",
    "as_of": "2026-10-03"
   },
   {
    "what": "Hazard process areas",
    "source": "SilvaProtect-CH (debris flow, rockfall, shallow landslide) and the map of potential permafrost distribution, FOEN. Share of the square reaching 250 m from each site, measured on the SilvaProtect-CH polygons of data.geo.admin.ch and, for permafrost, on wms.geo.admin.ch. Index maps, valid to 1:50,000",
    "as_of": "2026-10-04"
   },
   {
    "what": "Hydropower plants, dams, reservoir storage",
    "source": "Hydropower statistics (WASTA), dams under federal supervision and filling level of the storage lakes, Swiss Federal Office of Energy (SFOE)"
   },
   {
    "what": "Satellite scenes, snow and ice extent",
    "source": "swissEO S2-SR, swisstopo, contains modified Copernicus Sentinel data 2015-2026; the extent is the dashboard's own count on those scenes"
   },
   {
    "what": "Glacier thinning",
    "source": "Hugonnet et al. 2021, Nature 592 (ASTER satellite stereo pictures, 2000-2019), on Randolph Glacier Inventory 6.0 outlines"
   },
   {
    "what": "Grid records",
    "source": "Electricity production by source, national consumption, cross-border exchange and filling of the storage lakes: Swiss Federal Office of Energy, energy dashboard files (Swissgrid figures). Precipitation at Grimsel Hospiz and air temperature at Jungfraujoch: MeteoSwiss open data"
   },
   {
    "what": "Glacier area by year",
    "source": "OGGM standard projections v1.6.1 (Open Global Glacier Model, Maussion et al. 2019), CMIP5 runs, Randolph Glacier Inventory region 11 (Central Europe)"
   },
   {
    "what": "Past forecasts",
    "source": "Forecast archive of Open-Meteo (CC BY 4.0): zero-degree level and precipitation at the 15 site locations"
   },
   {
    "what": "Federal benchmark",
    "source": "Analyse des Wasserkraftpotenzials der Gletscherschmelze, report of the Federal Council in fulfilment of postulate 21.3974, appendix",
    "as_of": "2024-12-06"
   },
   {
    "what": "Ground height of plants and dams",
    "source": "swisstopo height service (api3.geo.admin.ch)"
   }
  ]
 }
}