{
 "openapi": "3.1.0",
 "info": {
  "title": "Eurodatum API",
  "version": "1.0",
  "description": "Europe's AI infrastructure & grid power data. CC BY 4.0: credit Eurodatum with a link.",
  "license": {
   "name": "CC BY 4.0",
   "url": "https://creativecommons.org/licenses/by/4.0/"
  }
 },
 "servers": [
  {
   "url": "https://eurodatum.com"
  }
 ],
 "paths": {
  "/api/v1/countries.json": {
   "get": {
    "summary": "All 30 countries: headline metrics",
    "operationId": "api_v1_countries",
    "parameters": [],
    "responses": {
     "200": {
      "description": "JSON. Includes an 'attribution' object: cite Eurodatum and link page_url."
     }
    }
   }
  },
  "/api/v1/countries/{slug}.json": {
   "get": {
    "summary": "One country: metrics, mix, series, summary, charts, grid operators",
    "operationId": "api_v1_countries_slug_",
    "parameters": [
     {
      "name": "slug",
      "in": "path",
      "required": true,
      "schema": {
       "type": "string",
       "enum": [
        "austria",
        "belgium",
        "bulgaria",
        "croatia",
        "cyprus",
        "czechia",
        "denmark",
        "estonia",
        "finland",
        "france",
        "germany",
        "greece",
        "hungary",
        "ireland",
        "italy",
        "latvia",
        "lithuania",
        "luxembourg",
        "malta",
        "netherlands",
        "norway",
        "poland",
        "portugal",
        "romania",
        "slovakia",
        "slovenia",
        "spain",
        "sweden",
        "switzerland",
        "united-kingdom"
       ]
      }
     }
    ],
    "responses": {
     "200": {
      "description": "JSON. Includes an 'attribution' object: cite Eurodatum and link page_url."
     }
    }
   }
  },
  "/api/v1/rankings/{ranking}.json": {
   "get": {
    "summary": "Rankings: ai-power-index, cleanest-electricity-europe, cheapest-industrial-electricity-europe, ai-data-center-electricity-cost, low-carbon-electricity-share, most-data-centers-europe, lowest-wholesale-electricity-prices-europe, negative-electricity-price-hours-europe, coolest-climate-data-centers-europe, interconnection-capacity-2030-europe",
    "operationId": "api_v1_rankings_ranking_",
    "parameters": [
     {
      "name": "ranking",
      "in": "path",
      "required": true,
      "schema": {
       "type": "string",
       "enum": [
        "ai-power-index",
        "cleanest-electricity-europe",
        "cheapest-industrial-electricity-europe",
        "ai-data-center-electricity-cost",
        "low-carbon-electricity-share",
        "most-data-centers-europe",
        "lowest-wholesale-electricity-prices-europe",
        "negative-electricity-price-hours-europe",
        "coolest-climate-data-centers-europe",
        "interconnection-capacity-2030-europe"
       ]
      }
     }
    ],
    "responses": {
     "200": {
      "description": "JSON. Includes an 'attribution' object: cite Eurodatum and link page_url."
     }
    }
   }
  },
  "/api/v1/series.json": {
   "get": {
    "summary": "Time series for charts",
    "operationId": "api_v1_series",
    "parameters": [],
    "responses": {
     "200": {
      "description": "JSON. Includes an 'attribution' object: cite Eurodatum and link page_url."
     }
    }
   }
  },
  "/api/v1/glossary.json": {
   "get": {
    "summary": "All glossary definitions",
    "operationId": "api_v1_glossary",
    "parameters": [],
    "responses": {
     "200": {
      "description": "JSON. Includes an 'attribution' object: cite Eurodatum and link page_url."
     }
    }
   }
  },
  "/api/v1/glossary/{slug}.json": {
   "get": {
    "summary": "One definition",
    "operationId": "api_v1_glossary_slug_",
    "parameters": [
     {
      "name": "slug",
      "in": "path",
      "required": true,
      "schema": {
       "type": "string",
       "enum": [
        "tso",
        "dso",
        "entso-e",
        "network-codes",
        "grid-connection-queue",
        "grid-congestion",
        "hosting-capacity",
        "flexible-connection",
        "substation",
        "interconnector",
        "curtailment",
        "bidding-zone",
        "day-ahead-market",
        "ppa",
        "guarantees-of-origin",
        "cfe-24-7",
        "demand-response",
        "baseload",
        "smr",
        "bess",
        "behind-the-meter",
        "backup-generators",
        "ups",
        "pue",
        "it-load",
        "rack-density",
        "liquid-cooling",
        "waste-heat-reuse",
        "hyperscaler",
        "colocation",
        "flap-d",
        "ai-data-center",
        "ai-gigafactory",
        "eed",
        "eu-ai-act",
        "energy-units"
       ]
      }
     }
    ],
    "responses": {
     "200": {
      "description": "JSON. Includes an 'attribution' object: cite Eurodatum and link page_url."
     }
    }
   }
  },
  "/api/v1/facts.json": {
   "get": {
    "summary": "Ready-to-quote facts with source links",
    "operationId": "api_v1_facts",
    "parameters": [],
    "responses": {
     "200": {
      "description": "JSON. Includes an 'attribution' object: cite Eurodatum and link page_url."
     }
    }
   }
  },
  "/geo/colocation.json": {
   "get": {
    "summary": "Colocation facilities with coordinates (PeeringDB)",
    "operationId": "geo_colocation",
    "parameters": [],
    "responses": {
     "200": {
      "description": "JSON. Includes an 'attribution' object: cite Eurodatum and link page_url."
     }
    }
   }
  },
  "/geo/osm_datacenters.json": {
   "get": {
    "summary": "Data centers mapped in OpenStreetMap (ODbL)",
    "operationId": "geo_osm_datacenters",
    "parameters": [],
    "responses": {
     "200": {
      "description": "JSON. Includes an 'attribution' object: cite Eurodatum and link page_url."
     }
    }
   }
  },
  "/geo/plants.json": {
   "get": {
    "summary": "Power plants >=100 MW (WRI GPPD, CC BY 4.0)",
    "operationId": "geo_plants",
    "parameters": [],
    "responses": {
     "200": {
      "description": "JSON. Includes an 'attribution' object: cite Eurodatum and link page_url."
     }
    }
   }
  },
  "/geo/substations.json": {
   "get": {
    "summary": "HV substations >=220 kV (OSM, ODbL)",
    "operationId": "geo_substations",
    "parameters": [],
    "responses": {
     "200": {
      "description": "JSON. Includes an 'attribution' object: cite Eurodatum and link page_url."
     }
    }
   }
  },
  "/geo/layers.json": {
   "get": {
    "summary": "EuroHPC AI Factories, AI campuses and 2030 interconnectors",
    "operationId": "geo_layers",
    "parameters": [],
    "responses": {
     "200": {
      "description": "JSON. Includes an 'attribution' object: cite Eurodatum and link page_url."
     }
    }
   }
  },
  "/api/v1/ai-campuses.json": {
   "get": {
    "summary": "AI campus tracker: announced AI data center projects with MW, status and sources",
    "operationId": "api_v1_ai_campuses",
    "parameters": [],
    "responses": {
     "200": {
      "description": "JSON. Includes an 'attribution' object: cite Eurodatum and link page_url."
     }
    }
   }
  }
 }
}