{"openapi":"3.1.0","info":{"title":"Volcanoes API","description":"API providing volcanic activity data from the Icelandic Meteorological Office (IMO).\n\n## Volcano Observatory Notice to Aviation (VONA) Notifications\n\nVONA is a standardized message used by volcano observatories to inform the aviation community about volcanic activity that could pose a hazard, such as ash clouds.\n\n## Aviation Color Code (ACC)\n\nThe Aviation Color Code follows recommendations of the International Civil Aviation Organization (ICAO) and provides pilots, the public, and aviation authorities with information about the status of volcanoes that could affect air traffic. The ACC is independent of the Volcano Alert Level System (VALS) color code and may differ from it at any given time.\n\n## Volcano Alert Level System (VALS)\n\nVALS is a system developed by the Icelandic Meteorological Office (IMO) to provide clear and simplified information about activity of volcanic systems in Iceland. It communicates potential hazards based on available monitoring data, geophysical and geochemical parameters, expert experience, and historical knowledge of past eruptions.","termsOfService":"https://en.vedur.is/about-imo/the-web/conditions","contact":{"name":"Veðurstofa Íslands","url":"https://www.vedur.is/um-vi/hafa-samband/","email":"fyrirspurnir@vedur.is"},"license":{"name":"Attribution 4.0 International (CC BY 4.0)","url":"https://creativecommons.org/licenses/by/4.0/"},"version":"2026-06-04"},"paths":{"/volcanoes":{"get":{"tags":["Volcanoes"],"summary":"Get Volcanoes","description":"List all volcanoes.","operationId":"list_volcanoes","parameters":[{"name":"include_geometry","in":"query","required":false,"schema":{"type":"boolean","description":"Include volcano feature geometries (caldera rims, fissure swarms, etc.)","default":false,"title":"Include Geometry"},"description":"Include volcano feature geometries (caldera rims, fissure swarms, etc.)"},{"name":"x-vi-api-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Vi-Api-Version"},"examples":{"Latest":{"summary":"Latest"},"2026-06-04":{"summary":"2026-06-04","value":"2026-06-04"}}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/VolcanoPublic"},"title":"Response List Volcanoes"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/volcanoes/{code}":{"get":{"tags":["Volcanoes"],"summary":"Get Volcano By Code","description":"Get detailed information about a specific volcano.","operationId":"get_volcano_by_code","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","title":"Code"},"examples":{"Askja":{"value":"ASK","description":"Volcano code (Askja)"},"Katla":{"value":"KAT","description":"Volcano code (Katla)"}}},{"name":"x-vi-api-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Vi-Api-Version"},"examples":{"Latest":{"summary":"Latest"},"2026-06-04":{"summary":"2026-06-04","value":"2026-06-04"}}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VolcanoPublic"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/vals":{"get":{"tags":["VALS"],"summary":"List all VALS entries","description":"Get a list of all Volcano Alert Level System (VALS) notices. Returns basic information without audit fields.","operationId":"list_vals_entries","parameters":[{"name":"x-vi-api-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Vi-Api-Version"},"examples":{"Latest":{"summary":"Latest"},"2026-06-04":{"summary":"2026-06-04","value":"2026-06-04"}}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ValsPublic"},"title":"Response List Vals Entries"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/vals/{vals_id}":{"get":{"tags":["VALS"],"summary":"Get VALS notice by ID","description":"Get detailed information about a specific Volcano Alert Level System (VALS) notice by its ID. Returns full details without audit fields.","operationId":"get_vals_notice","parameters":[{"name":"vals_id","in":"path","required":true,"schema":{"type":"integer","title":"Vals Id"}},{"name":"x-vi-api-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Vi-Api-Version"},"examples":{"Latest":{"summary":"Latest"},"2026-06-04":{"summary":"2026-06-04","value":"2026-06-04"}}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValsDetailsPublic"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/vona":{"get":{"tags":["VONA"],"summary":"List all VONA entries","description":"Get a list of all Volcano Observatory Notices for Aviation (VONA), ordered by publish time (newest first).","operationId":"list_vona_entries","parameters":[{"name":"x-vi-api-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Vi-Api-Version"},"examples":{"Latest":{"summary":"Latest"},"2026-06-04":{"summary":"2026-06-04","value":"2026-06-04"}}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/VonaPublic"},"title":"Response List Vona Entries"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/vona/{vona_id}":{"get":{"tags":["VONA"],"summary":"Get VONA notice by ID","description":"Get detailed information about a specific Volcano Observatory Notice for Aviation (VONA) by its ID. Returns either new format (with activity_status, source_elevation, etc.) or old format (with activity_summary) depending on when the VONA was created.","operationId":"get_vona_notice","parameters":[{"name":"vona_id","in":"path","required":true,"schema":{"type":"integer","title":"Vona Id"}},{"name":"x-vi-api-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Vi-Api-Version"},"examples":{"Latest":{"summary":"Latest"},"2026-06-04":{"summary":"2026-06-04","value":"2026-06-04"}}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/IcaoVonaDetailsPublic"},{"$ref":"#/components/schemas/ImoVonaDetailsPublic"}],"title":"Response Get Vona Notice"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/vwr":{"get":{"tags":["VWR"],"summary":"Get Vwr Notices","description":"Get all volcano weekly reports.","operationId":"list_vwr_notices","parameters":[{"name":"x-vi-api-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Vi-Api-Version"},"examples":{"Latest":{"summary":"Latest"},"2026-06-04":{"summary":"2026-06-04","value":"2026-06-04"}}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/VwrPublic"},"title":"Response List Vwr Notices"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/vwr/{vwr_id}":{"get":{"tags":["VWR"],"summary":"Get Volcano Weekly Report by ID","description":"Get a volcano weekly report by ID.","operationId":"get_vwr_notice_by_id","parameters":[{"name":"vwr_id","in":"path","required":true,"schema":{"type":"integer","examples":[1],"title":"Vwr Id"}},{"name":"x-vi-api-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Vi-Api-Version"},"examples":{"Latest":{"summary":"Latest"},"2026-06-04":{"summary":"2026-06-04","value":"2026-06-04"}}}],"responses":{"200":{"description":"Volcano Weekly Report (VWR) as JSON or PDF","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VwrDetailsPublic"}}}},"404":{"description":"Volcano Weekly Report not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/properties":{"get":{"tags":["Properties"],"summary":"Get all lookup table properties","description":"Retrieve all reference data including VONA aviation color codes, VALS alert levels, and volcanic zones.","operationId":"get_all_properties","parameters":[{"name":"x-vi-api-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Vi-Api-Version"},"examples":{"Latest":{"summary":"Latest"},"2026-06-04":{"summary":"2026-06-04","value":"2026-06-04"}}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PropertiesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/properties/{property_type}":{"get":{"tags":["Properties"],"summary":"Get properties by type","description":"Retrieve all items of a specific property type.","operationId":"get_properties_by_type","parameters":[{"name":"property_type","in":"path","required":true,"schema":{"$ref":"#/components/schemas/PropertyType"}},{"name":"x-vi-api-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Vi-Api-Version"},"examples":{"Latest":{"summary":"Latest"},"2026-06-04":{"summary":"2026-06-04","value":"2026-06-04"}}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/AviationColorCode"}},{"type":"array","items":{"$ref":"#/components/schemas/ValsLevel"}},{"$ref":"#/components/schemas/FeatureCollection"}],"title":"Response Get Properties By Type"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/properties/{property_type}/{identifier}":{"get":{"tags":["Properties"],"summary":"Get a single property by type and identifier","description":"Retrieve a single property item. For aviation-color-codes use code (e.g., RED), for vals-levels use level number (e.g., 0), for zones use marker (e.g., NVZ).","operationId":"get_property_by_type_and_id","parameters":[{"name":"property_type","in":"path","required":true,"schema":{"$ref":"#/components/schemas/PropertyType"}},{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}},{"name":"x-vi-api-version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Vi-Api-Version"},"examples":{"Latest":{"summary":"Latest"},"2026-06-04":{"summary":"2026-06-04","value":"2026-06-04"}}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/AviationColorCode"},{"$ref":"#/components/schemas/ValsLevel"},{"$ref":"#/components/schemas/Feature"}],"title":"Response Get Property By Type And Id"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"AviationColor":{"type":"string","enum":["GRAY","GREEN","YELLOW","ORANGE","RED"],"title":"AviationColor"},"AviationColorCode":{"properties":{"code":{"type":"string","title":"Code"},"code_is":{"type":"string","title":"Code Is"},"description_is":{"type":"string","title":"Description Is"},"description_en":{"type":"string","title":"Description En"}},"type":"object","required":["code","code_is","description_is","description_en"],"title":"AviationColorCode","example":{"code":"RED","code_is":"Rautt","description_en":"Eruption is ongoing with significant emission of ash into the atmosphere","description_is":"Eldgos í gangi með umtalsverðum gosaska"}},"BaseModel":{"properties":{},"type":"object","title":"BaseModel"},"Country":{"properties":{"iso_code":{"type":"string","title":"Iso Code"},"name_is":{"type":"string","title":"Name Is"},"name_en":{"type":"string","title":"Name En"}},"type":"object","required":["iso_code","name_is","name_en"],"title":"Country","example":{"iso_code":"IS","name_en":"Iceland","name_is":"Ísland"}},"Feature":{"properties":{"bbox":{"anyOf":[{"prefixItems":[{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"}],"type":"array","maxItems":4,"minItems":4},{"prefixItems":[{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"}],"type":"array","maxItems":6,"minItems":6},{"type":"null"}],"title":"Bbox"},"type":{"type":"string","const":"Feature","title":"Type"},"geometry":{"anyOf":[{"oneOf":[{"$ref":"#/components/schemas/Point"},{"$ref":"#/components/schemas/MultiPoint"},{"$ref":"#/components/schemas/LineString"},{"$ref":"#/components/schemas/MultiLineString"},{"$ref":"#/components/schemas/Polygon"},{"$ref":"#/components/schemas/MultiPolygon"},{"$ref":"#/components/schemas/GeometryCollection"}],"discriminator":{"propertyName":"type","mapping":{"GeometryCollection":"#/components/schemas/GeometryCollection","LineString":"#/components/schemas/LineString","MultiLineString":"#/components/schemas/MultiLineString","MultiPoint":"#/components/schemas/MultiPoint","MultiPolygon":"#/components/schemas/MultiPolygon","Point":"#/components/schemas/Point","Polygon":"#/components/schemas/Polygon"}}},{"type":"null"}],"title":"Geometry"},"properties":{"anyOf":[{"additionalProperties":true,"type":"object"},{"$ref":"#/components/schemas/BaseModel"},{"type":"null"}],"title":"Properties"},"id":{"anyOf":[{"type":"integer"},{"type":"string"},{"type":"null"}],"title":"Id"}},"type":"object","required":["type","geometry","properties"],"title":"Feature","description":"Feature Model"},"FeatureCollection":{"properties":{"bbox":{"anyOf":[{"prefixItems":[{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"}],"type":"array","maxItems":4,"minItems":4},{"prefixItems":[{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"}],"type":"array","maxItems":6,"minItems":6},{"type":"null"}],"title":"Bbox"},"type":{"type":"string","const":"FeatureCollection","title":"Type"},"features":{"items":{"$ref":"#/components/schemas/Feature"},"type":"array","title":"Features"}},"type":"object","required":["type","features"],"title":"FeatureCollection","description":"FeatureCollection Model"},"GeometryCollection":{"properties":{"bbox":{"anyOf":[{"prefixItems":[{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"}],"type":"array","maxItems":4,"minItems":4},{"prefixItems":[{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"}],"type":"array","maxItems":6,"minItems":6},{"type":"null"}],"title":"Bbox"},"type":{"type":"string","const":"GeometryCollection","title":"Type"},"geometries":{"items":{"oneOf":[{"$ref":"#/components/schemas/Point"},{"$ref":"#/components/schemas/MultiPoint"},{"$ref":"#/components/schemas/LineString"},{"$ref":"#/components/schemas/MultiLineString"},{"$ref":"#/components/schemas/Polygon"},{"$ref":"#/components/schemas/MultiPolygon"},{"$ref":"#/components/schemas/GeometryCollection"}],"discriminator":{"propertyName":"type","mapping":{"GeometryCollection":"#/components/schemas/GeometryCollection","LineString":"#/components/schemas/LineString","MultiLineString":"#/components/schemas/MultiLineString","MultiPoint":"#/components/schemas/MultiPoint","MultiPolygon":"#/components/schemas/MultiPolygon","Point":"#/components/schemas/Point","Polygon":"#/components/schemas/Polygon"}}},"type":"array","title":"Geometries"}},"type":"object","required":["type","geometries"],"title":"GeometryCollection","description":"GeometryCollection Model"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"IcaoVonaDetailsPublic":{"properties":{"id":{"type":"integer","title":"Id"},"volcano_code":{"type":"string","title":"Volcano Code"},"published_at":{"type":"string","format":"date-time","title":"Published At"},"aviation_color":{"$ref":"#/components/schemas/AviationColorCode"},"notice_number":{"type":"integer","title":"Notice Number"},"source_elevation":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Source Elevation"},"activity_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Activity Summary"},"activity_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Activity Status"},"last_va_emission_time":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Va Emission Time"},"onset_time":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Onset Time"},"duration":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Duration"},"cloud_height":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cloud Height"},"other_cloud_info":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Other Cloud Info"},"height_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Height Source"},"cloud_movement":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cloud Movement"},"remarks":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Remarks"}},"type":"object","required":["id","volcano_code","published_at","aviation_color","notice_number"],"title":"IcaoVonaDetails","description":"Full VONA as defined by ICAO PANS-MET Appendix 7, Table A7-1."},"ImoVonaDetailsPublic":{"properties":{"id":{"type":"integer","title":"Id"},"volcano_code":{"type":"string","title":"Volcano Code"},"published_at":{"type":"string","format":"date-time","title":"Published At"},"aviation_color":{"$ref":"#/components/schemas/AviationColorCode"},"notice_number":{"type":"integer","title":"Notice Number"},"activity_summary":{"type":"string","title":"Activity Summary"},"cloud_height":{"type":"string","title":"Cloud Height"},"other_cloud_info":{"type":"string","title":"Other Cloud Info"},"remarks":{"type":"string","title":"Remarks"}},"type":"object","required":["id","volcano_code","published_at","aviation_color","notice_number","activity_summary","cloud_height","other_cloud_info","remarks"],"title":"ImoVonaDetails","description":"Old VONA before ICAO PANS-MET defined by IMO"},"LineString":{"properties":{"bbox":{"anyOf":[{"prefixItems":[{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"}],"type":"array","maxItems":4,"minItems":4},{"prefixItems":[{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"}],"type":"array","maxItems":6,"minItems":6},{"type":"null"}],"title":"Bbox"},"type":{"type":"string","const":"LineString","title":"Type"},"coordinates":{"items":{"anyOf":[{"$ref":"#/components/schemas/Position2D"},{"$ref":"#/components/schemas/Position3D"}]},"type":"array","minItems":2,"title":"Coordinates"}},"type":"object","required":["type","coordinates"],"title":"LineString","description":"LineString Model"},"MultiLineString":{"properties":{"bbox":{"anyOf":[{"prefixItems":[{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"}],"type":"array","maxItems":4,"minItems":4},{"prefixItems":[{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"}],"type":"array","maxItems":6,"minItems":6},{"type":"null"}],"title":"Bbox"},"type":{"type":"string","const":"MultiLineString","title":"Type"},"coordinates":{"items":{"items":{"anyOf":[{"$ref":"#/components/schemas/Position2D"},{"$ref":"#/components/schemas/Position3D"}]},"type":"array","minItems":2},"type":"array","title":"Coordinates"}},"type":"object","required":["type","coordinates"],"title":"MultiLineString","description":"MultiLineString Model"},"MultiPoint":{"properties":{"bbox":{"anyOf":[{"prefixItems":[{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"}],"type":"array","maxItems":4,"minItems":4},{"prefixItems":[{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"}],"type":"array","maxItems":6,"minItems":6},{"type":"null"}],"title":"Bbox"},"type":{"type":"string","const":"MultiPoint","title":"Type"},"coordinates":{"items":{"anyOf":[{"$ref":"#/components/schemas/Position2D"},{"$ref":"#/components/schemas/Position3D"}]},"type":"array","title":"Coordinates"}},"type":"object","required":["type","coordinates"],"title":"MultiPoint","description":"MultiPoint Model"},"MultiPolygon":{"properties":{"bbox":{"anyOf":[{"prefixItems":[{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"}],"type":"array","maxItems":4,"minItems":4},{"prefixItems":[{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"}],"type":"array","maxItems":6,"minItems":6},{"type":"null"}],"title":"Bbox"},"type":{"type":"string","const":"MultiPolygon","title":"Type"},"coordinates":{"items":{"items":{"items":{"anyOf":[{"$ref":"#/components/schemas/Position2D"},{"$ref":"#/components/schemas/Position3D"}]},"type":"array","minItems":4},"type":"array"},"type":"array","title":"Coordinates"}},"type":"object","required":["type","coordinates"],"title":"MultiPolygon","description":"MultiPolygon Model"},"Point":{"properties":{"bbox":{"anyOf":[{"prefixItems":[{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"}],"type":"array","maxItems":4,"minItems":4},{"prefixItems":[{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"}],"type":"array","maxItems":6,"minItems":6},{"type":"null"}],"title":"Bbox"},"type":{"type":"string","const":"Point","title":"Type"},"coordinates":{"anyOf":[{"$ref":"#/components/schemas/Position2D"},{"$ref":"#/components/schemas/Position3D"}],"title":"Coordinates"}},"type":"object","required":["type","coordinates"],"title":"Point","description":"Point Model"},"Polygon":{"properties":{"bbox":{"anyOf":[{"prefixItems":[{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"}],"type":"array","maxItems":4,"minItems":4},{"prefixItems":[{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"}],"type":"array","maxItems":6,"minItems":6},{"type":"null"}],"title":"Bbox"},"type":{"type":"string","const":"Polygon","title":"Type"},"coordinates":{"items":{"items":{"anyOf":[{"$ref":"#/components/schemas/Position2D"},{"$ref":"#/components/schemas/Position3D"}]},"type":"array","minItems":4},"type":"array","title":"Coordinates"}},"type":"object","required":["type","coordinates"],"title":"Polygon","description":"Polygon Model"},"Position2D":{"prefixItems":[{"type":"number","title":"Longitude"},{"type":"number","title":"Latitude"}],"type":"array","maxItems":2,"minItems":2},"Position3D":{"prefixItems":[{"type":"number","title":"Longitude"},{"type":"number","title":"Latitude"},{"type":"number","title":"Altitude"}],"type":"array","maxItems":3,"minItems":3},"PropertiesResponse":{"properties":{"aviation-color-codes":{"items":{"$ref":"#/components/schemas/AviationColorCode"},"type":"array","title":"Aviation-Color-Codes"},"vals-levels":{"items":{"$ref":"#/components/schemas/ValsLevel"},"type":"array","title":"Vals-Levels"},"zones":{"$ref":"#/components/schemas/FeatureCollection"}},"type":"object","title":"PropertiesResponse","description":"Response model for properties endpoint containing requested lookup tables.","example":{"aviation-color-codes":[{"code":"RED","code_is":"Rautt","description_en":"Eruption is ongoing with significant emission of ash into the atmosphere.","description_is":"Eldgos er yfirvofandi eða hafið – líklegt er að aska berist upp í lofthjúpinn. Eða, eldgos stendur yfir og veruleg aska berst upp í andrúmsloftið."}],"vals-levels":[{"code_en":"Yellow","code_is":"Gult","description_en":"Volcanic unrest","description_is":"Aukin virkni","level":1}],"zones":{"features":[{"geometry":{"coordinates":[],"type":"MultiPolygon"},"properties":{"marker":"NRR","name_is":"Norður Reykjaneshryggur","name_en":"Northern Reykjanes Ridge","geom_name":"Zone boundary","source":"IMO","owner":"IMO"},"type":"Feature"}],"type":"FeatureCollection"}}},"PropertyType":{"type":"string","enum":["aviation-color-codes","vals-levels","zones"],"title":"PropertyType"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"ValsAlertLevel":{"type":"integer","enum":[0,1,2,3],"title":"ValsAlertLevel"},"ValsDetailsPublic":{"properties":{"id":{"type":"integer","title":"Id"},"volcano_code":{"type":"string","title":"Volcano Code"},"published_at":{"type":"string","format":"date-time","title":"Published At"},"alert_level_info":{"$ref":"#/components/schemas/ValsLevel"},"hazards":{"items":{"$ref":"#/components/schemas/ValsHazard"},"type":"array","title":"Hazards","default":[]},"activity_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Activity Summary"},"evolution_scenarios":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Evolution Scenarios"},"remarks":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Remarks"}},"type":"object","required":["id","volcano_code","published_at","alert_level_info"],"title":"ValsDetails","example":{"activity_summary":"Increased seismic activity detected","evolution_scenarios":"Possible escalation to level 2","hazards":[{"hazard_type":"earthquakes","id":1},{"hazard_type":"gas-pollution","id":2}],"id":123,"level":{"code_en":"Yellow","code_is":"Gult","description_en":"Minor volcanic unrest","description_is":"TODO","level":1},"published_at":"2026-03-30T16:00:00Z","remarks":"Monitoring intensified","volcano_code":"ASK"}},"ValsHazard":{"properties":{"id":{"type":"integer","title":"Id"},"hazard_type":{"$ref":"#/components/schemas/ValsHazardType"}},"type":"object","required":["id","hazard_type"],"title":"ValsHazard","example":{"hazard_type":"earthquakes","id":1}},"ValsHazardType":{"type":"string","enum":["ballistics","changes-to-cauldrons","changes-to-the-water-table","changes-to-hot-springs","explosions","earthquakes","fault-movements","floods","gas-pollution","lahars","landslides","lava-flows","lightning","limnic-eruption","pyroclastic-density-currents","steam-explosions","tephra-fallout","tsunamis","formation-of-crevasses"],"title":"ValsHazardType"},"ValsLevel":{"properties":{"level":{"type":"integer","title":"Level"},"code_is":{"type":"string","title":"Code Is"},"code_en":{"type":"string","title":"Code En"},"description_is":{"type":"string","title":"Description Is"},"description_en":{"type":"string","title":"Description En"}},"type":"object","required":["level","code_is","code_en","description_is","description_en"],"title":"ValsLevel","example":{"code_en":"Yellow","code_is":"Gult","description_en":"Volcanic unrest","description_is":"Töluvert aukin virkni","level":1}},"ValsPublic":{"properties":{"id":{"type":"integer","title":"Id"},"volcano_code":{"type":"string","title":"Volcano Code"},"published_at":{"type":"string","format":"date-time","title":"Published At"},"alert_level_info":{"$ref":"#/components/schemas/ValsLevel"}},"type":"object","required":["id","volcano_code","published_at","alert_level_info"],"title":"Vals","example":{"id":123,"published_at":"2026-03-30T16:00:00Z","volcano_code":"ASK"}},"ValsTimelinePublic":{"properties":{"current":{"anyOf":[{"$ref":"#/components/schemas/ValsPublic"},{"type":"null"}]},"previous":{"anyOf":[{"$ref":"#/components/schemas/ValsPublic"},{"type":"null"}]},"total_actual":{"type":"integer","title":"Total Actual","default":0},"history":{"items":{"$ref":"#/components/schemas/ValsPublic"},"type":"array","title":"History","default":[]}},"type":"object","title":"ValsTimeline"},"VolcanoPublic":{"properties":{"code":{"type":"string","title":"Code"},"name":{"type":"string","title":"Name"},"si_name":{"type":"string","title":"Si Name"},"si_code":{"type":"string","title":"Si Code"},"country":{"$ref":"#/components/schemas/Country"},"zone":{"anyOf":[{"$ref":"#/components/schemas/Zone"},{"type":"null"}]},"height":{"type":"integer","title":"Height"},"alt_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Alt Name"},"geom_point":{"anyOf":[{"$ref":"#/components/schemas/Point"},{"type":"null"}]},"min_plume_height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Plume Height"},"max_plume_height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Plume Height"},"possible_max_plume_height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Possible Max Plume Height","description":"KM"},"predominant_activity_stage_one":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Predominant Activity Stage One"},"predominant_activity_stage_two":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Predominant Activity Stage Two"},"prob_duration_effusive":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prob Duration Effusive"},"prob_duration_explosive":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prob Duration Explosive"},"sulfur_emission_potential_silicic":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sulfur Emission Potential Silicic","description":"PPM"},"sulfur_emission_potential_basaltic":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sulfur Emission Potential Basaltic","description":"PPM"},"iwxxm_identifier":{"type":"string","format":"uuid","title":"Iwxxm Identifier"},"bulletin_identifier":{"type":"string","title":"Bulletin Identifier"},"vona":{"$ref":"#/components/schemas/VonaTimelinePublic"},"vals":{"$ref":"#/components/schemas/ValsTimelinePublic"},"features":{"anyOf":[{"$ref":"#/components/schemas/FeatureCollection"},{"type":"null"}]}},"type":"object","required":["code","name","si_name","si_code","country","height","geom_point","iwxxm_identifier","bulletin_identifier","vona","vals"],"title":"Volcano","example":{"alt_name":"Askja-Dyngjufjöll, Askja-Hrúthálsar","code":"ASK","country":{"iso_code":"IS","name_en":"Iceland","name_is":"Ísland"},"features":[{"feature_type":"Caldera rim","fid":1,"geom":{"coordinates":[[-16.8,65.03],[-16.81,65.04]],"type":"LineString"},"source":"IMO"}],"geom_point":{"coordinates":[-16.75,65.03],"type":"Point"},"height":1516,"max_plume_height":12,"min_plume_height":3,"name":"Askja","possible_max_plume_height":35,"predominant_activity_stage_one":"Effusive","predominant_activity_stage_two":"Explosive","prob_duration_effusive":"weeks to months","prob_duration_explosive":"hours to weeks","si_code":"373060","si_name":"Askja","sulfur_emission_potential_basaltic":1200,"sulfur_emission_potential_silicic":100,"vals":{"history":[],"total_actual":0},"vona":{"history":[],"total_actual":0},"zone":{"marker":"NVZ","name_en":"Northern Volcanic Zone","name_is":"Norðurgosbelti"}}},"VonaPublic":{"properties":{"id":{"type":"integer","title":"Id"},"volcano_code":{"type":"string","title":"Volcano Code"},"published_at":{"type":"string","format":"date-time","title":"Published At"},"aviation_color":{"$ref":"#/components/schemas/AviationColorCode"},"notice_number":{"type":"integer","title":"Notice Number"}},"type":"object","required":["id","volcano_code","published_at","aviation_color","notice_number"],"title":"Vona","description":"Full VONA as defined by ICAO PANS-MET Appendix 7, Table A7-1."},"VonaTimelinePublic":{"properties":{"current":{"anyOf":[{"$ref":"#/components/schemas/VonaPublic"},{"type":"null"}]},"previous":{"anyOf":[{"$ref":"#/components/schemas/VonaPublic"},{"type":"null"}]},"total_actual":{"type":"integer","title":"Total Actual","default":0},"history":{"items":{"$ref":"#/components/schemas/VonaPublic"},"type":"array","title":"History","default":[]}},"type":"object","title":"VonaTimeline"},"VwrDetailsPublic":{"properties":{"id":{"type":"integer","title":"Id"},"published_at":{"type":"string","format":"date-time","title":"Published At"},"entries":{"items":{"$ref":"#/components/schemas/VwrEntryPublic"},"type":"array","title":"Entries"},"additional_notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Additional Notes"}},"type":"object","required":["id","published_at"],"title":"VwrDetails"},"VwrEntryPublic":{"properties":{"volcano_code":{"type":"string","title":"Volcano Code"},"vona_color_code":{"anyOf":[{"$ref":"#/components/schemas/AviationColor"},{"type":"null"}]},"vals_level":{"anyOf":[{"$ref":"#/components/schemas/ValsAlertLevel"},{"type":"null"}]},"status_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status Text"}},"type":"object","required":["volcano_code","vona_color_code","vals_level"],"title":"VwrEntry"},"VwrPublic":{"properties":{"id":{"type":"integer","title":"Id"},"published_at":{"type":"string","format":"date-time","title":"Published At"},"entries":{"items":{"$ref":"#/components/schemas/VwrEntryPublic"},"type":"array","title":"Entries"},"additional_notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Additional Notes"}},"type":"object","required":["id","published_at"],"title":"Vwr"},"Zone":{"properties":{"marker":{"type":"string","title":"Marker"},"name_is":{"type":"string","title":"Name Is"},"name_en":{"type":"string","title":"Name En"}},"type":"object","required":["marker","name_is","name_en"],"title":"Zone","example":{"marker":"NRR","name_en":"Northern Reykjanes Ridge","name_is":"Norður Reykjaneshryggur"}}}},"servers":[{"url":"/volcanoes"}]}