{"openapi":"3.0.3","info":{"title":"DataCenterMap API","version":"1.0.0","description":"Programmatic access to global **data center**, **power plant**, and **energy/environment** datasets.\n\n### Authentication\nProduction endpoints require an API key: `Authorization: Bearer dcm_live_...`. Create one free at [https://datacentermap.info/account/login](https://datacentermap.info/account/login).\n\n### No-account sandbox\nEvery read endpoint is also exposed under `/api/sandbox` with **no key required** (IP rate-limited, capped page size, whitelisted parameters). Use the *Sandbox* server below to try requests now.\n\n### Plans & quota\n- **Free** — free, 200 requests/mo, 5 req/s\n- **Starter** — $19.99/mo, 50,000 requests/mo, 10 req/s\n- **Pro** — $49.99/mo, 500,000 requests/mo, 25 req/s\n- **Ultra** — $99.99/mo, 5,000,000 requests/mo, 50 req/s\n- **Pay as you go** — no subscription; buy prepaid request packs (10,000 for $20, 50,000 for $75, 250,000 for $250). Credits are used after the monthly quota and stay valid 12 months.\n- **Enterprise** — custom volume, SLA & bulk export. [Contact us](https://datacentermap.info/pricing.html#enterprise).\n\nResponses include `X-RateLimit-Remaining`; sandbox responses include `X-Sandbox-Remaining`.\n\n### Data & attribution\n- Data centers: DataCenterMap curated dataset + OpenStreetMap contributors (ODbL)\n- Power plants: © World Resources Institute — Global Power Plant Database v1.3.0 (CC-BY-4.0)\n\nCurrently indexing **583 data centers**, **34,936 power plants**, and country-level **emissions** (218) and **energy** (220) datasets.\n\n### Disclaimer\nData is provided AS IS and may be incomplete or inaccurate; we do not guarantee its accuracy. Upstream sources are cited and the original source for any record is available on request. We accept no liability for any action or inaction taken based on this data. The service is provided without warranties of any kind. See https://datacentermap.info/pricing.html#terms.","contact":{"name":"DataCenterMap","url":"https://datacentermap.info"},"termsOfService":"https://datacentermap.info/pricing.html#terms","license":{"name":"Data: CC-BY-4.0 / ODbL (see attribution)","url":"https://datacentermap.info/api.html"},"x-disclaimer":"Data is provided AS IS and may be incomplete or inaccurate; we do not guarantee its accuracy. Upstream sources are cited and the original source for any record is available on request. We accept no liability for any action or inaction taken based on this data. The service is provided without warranties of any kind. See https://datacentermap.info/pricing.html#terms."},"servers":[{"url":"https://datacentermap.info/api/sandbox","description":"Sandbox — no account required (rate-limited)"},{"url":"https://datacentermap.info/api","description":"Production — requires API key"}],"security":[{},{"ApiKeyAuth":[]}],"tags":[{"name":"Data centers","description":"Colocation campuses, cloud regions, and network PoPs."},{"name":"Power plants","description":"Global power generation facilities (WRI GPPD)."},{"name":"Energy & environment","description":"Country emissions & energy mix (Our World in Data) and cloud regions."},{"name":"Reference","description":"Stats, fuel types, and account/usage."}],"paths":{"/v1/datacenters":{"get":{"tags":["Data centers"],"summary":"List / search data centers","parameters":[{"name":"country","in":"query","schema":{"type":"string"},"example":"USA","description":"Country name (exact or substring)."},{"name":"state","in":"query","schema":{"type":"string"},"example":"VA","description":"US state code (exact)."},{"name":"operator","in":"query","schema":{"type":"string"},"example":"Equinix","description":"Operator substring."},{"name":"type","in":"query","schema":{"type":"string"},"example":"Colocation","description":"Facility type substring (Colocation, Edge PoP, Cloud Region…)."},{"name":"q","in":"query","schema":{"type":"string"},"description":"Free-text search over name/operator/city."},{"name":"bbox","in":"query","schema":{"type":"string"},"example":"-78,38,-76,40","description":"Bounding box minLng,minLat,maxLng,maxLat."},{"name":"limit","in":"query","schema":{"type":"integer","default":50},"description":"Max results (sandbox cap: 25)."},{"name":"offset","in":"query","schema":{"type":"integer","default":0}}],"responses":{"200":{"description":"A paginated list of results.","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"type":"integer","example":583},"limit":{"type":"integer","example":50},"offset":{"type":"integer","example":0},"data":{"type":"array","items":{"$ref":"#/components/schemas/DataCenter"}},"attribution":{"type":"string"}}},"example":{"total":583,"limit":50,"offset":0,"data":[{"id":"equinix-dc-campus-ashburn","name":"Equinix DC Campus (Ashburn)","operator":"Equinix","city":"Ashburn","state":"VA","country":"USA","type":"Colocation","lat":39.0153,"lng":-77.4641,"source":"datacentermap_nova"}],"attribution":"DataCenterMap curated dataset + OpenStreetMap contributors (ODbL)"}}}},"400":{"description":"Unsupported query parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"invalid_param","message":"Unsupported query parameter(s): foo. Allowed: country, state, operator, type, q, bbox, limit, offset."}}}},"429":{"description":"Rate limit / quota exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/datacenters/{id}":{"get":{"tags":["Data centers"],"summary":"Get a data center by id","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"example":"equinix-dc-campus-ashburn"}],"responses":{"200":{"description":"A data center.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataCenter"},"example":{"id":"equinix-dc-campus-ashburn","name":"Equinix DC Campus (Ashburn)","operator":"Equinix","city":"Ashburn","state":"VA","country":"USA","type":"Colocation","lat":39.0153,"lng":-77.4641,"source":"datacentermap_nova"}}}},"404":{"description":"Resource not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"not_found","message":"No data center with id 'foo'."}}}}}}},"/v1/powerplants":{"get":{"tags":["Power plants"],"summary":"List / search power plants","parameters":[{"name":"country","in":"query","schema":{"type":"string"},"example":"United States of America","description":"Country (exact or substring)."},{"name":"fuel","in":"query","schema":{"type":"string","enum":["Biomass","Coal","Cogeneration","Gas","Geothermal","Hydro","Nuclear","Oil","Other","Petcoke","Solar","Storage","Waste","Wave and Tidal","Wind"]},"example":"Solar","description":"Primary fuel (exact)."},{"name":"min_mw","in":"query","schema":{"type":"number"},"example":100,"description":"Minimum capacity in MW."},{"name":"q","in":"query","schema":{"type":"string"},"description":"Free-text search over plant name."},{"name":"bbox","in":"query","schema":{"type":"string"},"description":"Bounding box minLng,minLat,maxLng,maxLat."},{"name":"limit","in":"query","schema":{"type":"integer","default":50},"description":"Max results (sandbox cap: 25). Sorted by capacity desc."},{"name":"offset","in":"query","schema":{"type":"integer","default":0}}],"responses":{"200":{"description":"A paginated list of results.","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"type":"integer","example":583},"limit":{"type":"integer","example":50},"offset":{"type":"integer","example":0},"data":{"type":"array","items":{"$ref":"#/components/schemas/PowerPlant"}},"attribution":{"type":"string"}}},"example":{"total":34936,"limit":50,"offset":0,"data":[{"id":"three-gorges-dam","name":"Three Gorges Dam","fuel":"Hydro","capacity_mw":22500,"country":"China","lat":30.8235,"lng":111.0032}],"attribution":"© World Resources Institute — Global Power Plant Database v1.3.0 (CC-BY-4.0)"}}}},"400":{"description":"Unsupported query parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/powerplants/{id}":{"get":{"tags":["Power plants"],"summary":"Get a power plant by id","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"example":"three-gorges-dam"}],"responses":{"200":{"description":"A power plant.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PowerPlant"},"example":{"id":"three-gorges-dam","name":"Three Gorges Dam","fuel":"Hydro","capacity_mw":22500,"country":"China","lat":30.8235,"lng":111.0032}}}},"404":{"description":"Resource not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"not_found","message":"No data center with id 'foo'."}}}}}}},"/v1/emissions":{"get":{"tags":["Energy & environment"],"summary":"Country CO₂ & greenhouse-gas emissions (latest year)","parameters":[{"name":"country","in":"query","schema":{"type":"string"},"example":"USA","description":"Country name or ISO3 code."},{"name":"limit","in":"query","schema":{"type":"integer","default":50}},{"name":"offset","in":"query","schema":{"type":"integer","default":0}}],"responses":{"200":{"description":"Per-country emissions.","content":{"application/json":{"example":{"total":218,"limit":50,"offset":0,"data":[{"country":"United States","iso_code":"USA","year":2023,"co2_mt":4900,"co2_per_capita_t":14.3,"share_global_co2":13}],"attribution":"Our World in Data — CO2 and Greenhouse Gas Emissions (CC-BY-4.0)"}}}}}}},"/v1/energy":{"get":{"tags":["Energy & environment"],"summary":"Country energy mix & electricity demand (latest year)","parameters":[{"name":"country","in":"query","schema":{"type":"string"},"example":"Germany","description":"Country name or ISO3 code."},{"name":"limit","in":"query","schema":{"type":"integer","default":50}},{"name":"offset","in":"query","schema":{"type":"integer","default":0}}],"responses":{"200":{"description":"Per-country energy.","content":{"application/json":{"example":{"total":220,"limit":50,"offset":0,"data":[{"country":"Germany","iso_code":"DEU","year":2023,"electricity_demand_twh":510,"renewables_share_energy":22.1,"fossil_share_energy":76.2}],"attribution":"Our World in Data — Energy (CC-BY-4.0)"}}}}}}},"/v1/cloud":{"get":{"tags":["Energy & environment"],"summary":"Cloud provider regions (AWS + GCP)","responses":{"200":{"description":"Region lists.","content":{"application/json":{"example":{"aws":{"regions":["us-east-1","eu-west-1"]},"gcp":{"regions":["us-central1"]},"attribution":"AWS & Google Cloud published IP-range reference data"}}}}}}},"/v1/fuels":{"get":{"tags":["Reference"],"summary":"List power-plant fuel types","responses":{"200":{"description":"Distinct fuel types.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"string"}}}},"example":{"data":["Biomass","Coal","Cogeneration","Gas","Geothermal","Hydro","Nuclear","Oil","Other","Petcoke","Solar","Storage","Waste","Wave and Tidal","Wind"]}}}}}}},"/v1/stats":{"get":{"tags":["Reference"],"summary":"Dataset statistics & aggregations","responses":{"200":{"description":"Counts and top breakdowns.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Stats"}}}}}}},"/v1/whoami":{"get":{"tags":["Reference"],"summary":"Identify the calling key's plan","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Plan info.","content":{"application/json":{"example":{"plan":"pro"}}}},"401":{"description":"Missing API key."}}}},"/v1/usage":{"get":{"tags":["Reference"],"summary":"This month's usage & remaining quota","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Usage.","content":{"application/json":{"example":{"plan":"pro","limit":500000,"remaining":498734}}}}}}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"http","scheme":"bearer","bearerFormat":"dcm_live_*","description":"Your API key from the account dashboard. Sandbox endpoints need no auth."}},"schemas":{"DataCenter":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"operator":{"type":"string"},"city":{"type":"string"},"state":{"type":"string"},"country":{"type":"string"},"type":{"type":"string"},"lat":{"type":"number"},"lng":{"type":"number"},"source":{"type":"string"}},"example":{"id":"equinix-dc-campus-ashburn","name":"Equinix DC Campus (Ashburn)","operator":"Equinix","city":"Ashburn","state":"VA","country":"USA","type":"Colocation","lat":39.0153,"lng":-77.4641,"source":"datacentermap_nova"}},"PowerPlant":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"fuel":{"type":"string"},"capacity_mw":{"type":"number","nullable":true},"country":{"type":"string"},"lat":{"type":"number"},"lng":{"type":"number"}},"example":{"id":"three-gorges-dam","name":"Three Gorges Dam","fuel":"Hydro","capacity_mw":22500,"country":"China","lat":30.8235,"lng":111.0032}},"Stats":{"type":"object","example":{"datacenters":{"total":583,"by_country":{"USA":360},"by_type":{"Colocation":210}},"powerplants":{"total":34936,"total_capacity_mw":6500000,"by_fuel":{"Solar":9000,"Hydro":7000}},"attribution":["DataCenterMap curated dataset + OpenStreetMap contributors (ODbL)","© World Resources Institute — Global Power Plant Database v1.3.0 (CC-BY-4.0)"]}},"Error":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}}