{"openapi":"3.1.0","info":{"title":"Volcanoes API","version":"1.0.0","description":"The Smithsonian Global Volcanism Program (GVP) Holocene volcano list as an API — 1,215 volcanoes active within the last ~10,000 years. Look up any volcano by its GVP number (e.g. 211020 → Vesuvius) or name; search by name, country, type or region; or find every volcano within a radius of any coordinate (great-circle distance). Each record carries the volcano type, last-known eruption year, country/region, latitude/longitude, summit elevation, tectonic setting and a geological summary. Ideal for natural-hazard dashboards, travel/geography apps, education and earth-science tooling.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/volcanoes-api","description":"oanor gateway"}],"tags":[{"name":"Volcanoes"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/nearby":{"get":{"operationId":"get_v1_nearby","tags":["Volcanoes"],"summary":"Volcanoes within a radius of a coordinate","description":"","parameters":[{"name":"lat","in":"query","required":false,"description":"Latitude (-90..90)","schema":{"type":"string"},"example":"35.68"},{"name":"lon","in":"query","required":false,"description":"Longitude (-180..180)","schema":{"type":"string"},"example":"139.69"},{"name":"radius_km","in":"query","required":false,"description":"Search radius in km (1-20000, default 500)","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max results (1-100, default 10)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":10,"total":49,"center":{"lat":35.68,"lon":139.69},"results":[{"id":283020,"name":"Hakoneyama","type":"Complex","region":"Northwestern Pacific Volcanic Regions","country":"Japan","landform":"Composite","latitude":35.233,"longitude":139.021,"subregion":"Izu Volcanic Arc","distance_km":78.4,"elevation_m":1438,"last_eruption":"2015","geologic_epoch":"Holocene","tectonic_setting":"Subduction zone / Continental crust (> 25 km)"},{"id":283030,"name":"Fujisan","type":"Stratovolcano","region":"Northwestern Pacific Volcanic Regions","country":"Japan","landform":"Composite","latitude":35.361,"longitude":138.728,"subregion":"Izu Volcanic Arc","distance_km":94,"elevation_m":3776,"last_eruption":"1708","geologic_epoch":"Holocene","tectonic_setting":"Subduction zone / Continental crust (> 25 km)"},{"id":283010,"name":"Izu-Tobu","type":"Pyroclastic cone(s)","region":"Northwestern Pacific Volcanic Regions","country":"Japan","landform":"Cluster","latitude":34.9,"longitude":139.098,"subregion":"Izu Volcanic Arc","distance_km":102,"elevation_m":1406,"last_eruption":"1989","geologic_epoch":"Holocene","tectonic_setting":"Subduction zone / Continental crust (> 25 km)"},{"id":283130,"name":"Akagisan","type":"Stratovolcano","region":"Northwestern Pacific Volcanic Regions","country":"Japan","landform":"Composite","latitude":36.56,"longitude":139.193,"subregion":"Northeast Japan Volcanic Arc","distance_km":107.6,"elevation_m":1828,"geologic_epoch":"Holocene","tectonic_setting":"Subduction zone / Continental crust (> 25 km)"},{"id":284010,"name":"Izu-Oshima","type":"Stratovolcano","region":"Northwestern Pacific Volcanic Regions","country":"Japan","landform":"Composite","latitude":34.724,"longitude":139.394,"subregion":"Izu Volcanic Arc","distance_km":109.7,"elevation_m":746,"last_eruption":"1990","geologic_epoch":"Holocene","tectonic_setting":"Subduction zone / Oceanic crust (< 15 km)"},{"id":283122,"name":"Harunasan","type":"Stratovolcano","region":"Northwestern Pacific Volcanic Regions","country":"Japan","landform":"Composite","latitude":36.477,"longitude":138.851,"subregion":"Northeast Japan Volcanic Arc","distance_km":116.4,"elevation_m":1449,"last_eruption":"550","geologic_epoch":"Holocene","tectonic_setting":"Subduction zone / Continental crust (> 25 km)"},{"id":283141,"name":"Nantaisan","type":"Stratovolcano","region":"Northwestern Pacific Volcanic Regions","country":"Japan","landform":"Composite","latitude":36.765,"longitude":139.491,"subregion":"Northeast Japan Volcanic Arc","distance_km":122,"elevation_m":2486,"last_eruption":"-9540","geologic_epoch":"Holocene","tectonic_setting":"Subduction zone / Continental crust (> 25 km)"},{"id":283142,"name":"Omanago Group","type":"Lava dome(s)","region":"Northwestern Pacific Volcanic Regions","country":"Japan","landform":"Cluster","latitude":36.8067,"longitude":139.4756,"subregion":"Northeast Japan Volcanic Arc","distance_km":126.8,"elevation_m":2341,"last_eruption":"-3050","geologic_epoch":"Holocene","tectonic_setting":"Subduction zone / Continental crust (> 25 km)"},{"id":283140,"name":"Nikko-Shiranesan","type":"Shield","region":"Northwestern Pacific Volcanic Regions","country":"Japan","landform":"Shield","latitude":36.799,"longitude":139.376,"subregion":"Northeast Japan Volcanic Arc","distance_km":127.6,"elevation_m":2578,"last_eruption":"1952","geologic_epoch":"Holocene","tectonic_setting":"Subduction zone / Continental crust (> 25 km)"},{"id":283031,"name":"Yokodake","type":"Stratovolcano(es)","region":"Northwestern Pacific Volcanic Regions","country":"Japan","landform":"Composite","latitude":36.087,"longitude":138.32,"subregion":"Northeast Japan Volcanic Arc","distance_km":131.5,"elevation_m":2480,"last_eruption":"1200","geologic_epoch":"Holocene","tectonic_setting":"Subduction zone / Continental crust (> 25 km)"}],"radius_km":500},"meta":{"timestamp":"2026-05-31T03:47:07.635Z","request_id":"63ee00bd-afdf-41cf-ae4b-92aefa08c9b2"},"status":"ok","message":"Nearby volcanoes listed","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Volcanoes"],"summary":"Search by name with country / type / region filters","description":"","parameters":[{"name":"q","in":"query","required":false,"description":"Name search, e.g. fuji","schema":{"type":"string"},"example":"fuji"},{"name":"country","in":"query","required":false,"description":"Country, e.g. Italy","schema":{"type":"string"}},{"name":"type","in":"query","required":false,"description":"Volcano type, e.g. Stratovolcano, Caldera, Shield","schema":{"type":"string"}},{"name":"region","in":"query","required":false,"description":"Volcanic region substring","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Results per page (1-100, default 20)","schema":{"type":"string"},"example":"20"},{"name":"offset","in":"query","required":false,"description":"Pagination offset","schema":{"type":"string"},"example":"0"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":1,"limit":20,"query":"fuji","total":1,"offset":0,"filters":[],"results":[{"id":283030,"name":"Fujisan","type":"Stratovolcano","region":"Northwestern Pacific Volcanic Regions","country":"Japan","landform":"Composite","latitude":35.361,"longitude":138.728,"subregion":"Izu Volcanic Arc","elevation_m":3776,"last_eruption":"1708","geologic_epoch":"Holocene","tectonic_setting":"Subduction zone / Continental crust (> 25 km)"}]},"meta":{"timestamp":"2026-05-31T03:47:07.707Z","request_id":"a08cbf86-a673-465c-aa9f-3318f2d8c544"},"status":"ok","message":"Volcanoes listed","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/volcano":{"get":{"operationId":"get_v1_volcano","tags":["Volcanoes"],"summary":"A single volcano by GVP number or name","description":"","parameters":[{"name":"id","in":"query","required":false,"description":"GVP volcano number, e.g. 211020 (Vesuvius)","schema":{"type":"string"},"example":"211020"},{"name":"name","in":"query","required":false,"description":"Volcano name, e.g. Vesuvius","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":211020,"name":"Vesuvius","type":"Stratovolcano","region":"European Volcanic Regions","country":"Italy","summary":"One of the world's most noted volcanoes, Vesuvius (Vesuvio) forms a dramatic backdrop to the Bay of Naples. The active cone was constructed within a large caldera of the older Monte Somma edifice, thought to have formed incrementally beginning about 17,000 years ago. The Monte Somma caldera wall has channeled lava flows and pyroclastic flows primarily to the south and west. Eight major explosive eruptions have taken place in the last 17,000 years, often accompanied by large pyroclastic flows and surges, such as during the 79 CE Pompeii eruption. Intermittent eruptions since 79 CE were followed by a period of frequent long-term explosive and effusive eruptions between 1631 and 1944. The large 1631 eruption produced pyroclastic flows that reached as far as the coast and caused great destruction. Many towns are located on the flanks, and several million people live within areas that could be affected by eruptions.","landform":"Composite","latitude":40.821,"longitude":14.426,"subregion":"Italian Peninsula Volcanic Provinces","elevation_m":1281,"last_eruption":"1944","geologic_epoch":"Holocene","tectonic_setting":"Subduction zone / Continental crust (> 25 km)"},"meta":{"timestamp":"2026-05-31T03:47:07.777Z","request_id":"26db9592-f8ae-4c4b-a716-f5fb9059cefe"},"status":"ok","message":"Volcano retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Totals & source","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Holocene volcanoes (active in the last ~10,000 years). id = GVP volcano number.","total":1215,"types":27,"fields":["id","name","type","landform","last_eruption","country","region","subregion","tectonic_setting","geologic_epoch","latitude","longitude","elevation_m","summary"],"source":"Smithsonian Global Volcanism Program (GVP) — Holocene Volcano List","countries":88},"meta":{"timestamp":"2026-05-31T03:47:07.823Z","request_id":"892969e7-9d10-47c6-ae46-8b40eddb9a81"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":3000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":650,"monthly_call_quota":45000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1700,"monthly_call_quota":220000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":4300,"monthly_call_quota":1100000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/volcanoes-api"}