{"openapi":"3.1.0","info":{"title":"Quakes API","description":"API for earthquake catalog access","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-08-06"},"paths":{"/events":{"get":{"tags":["Events"],"summary":"Returns Quake Information As Geojson Or Csv.","operationId":"Returns_quake_information_as_GeoJSON_or_CSV__events_get","parameters":[{"name":"start_time","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Start time on format **yyyy-mm-ddTHH:MM:SS±HH:MM**(timezone info is optional), valid values are between 7th January 1991 and midnight of tomorrow. Defaults to 7 days ago UTC.","title":"Start Time"},"description":"Start time on format **yyyy-mm-ddTHH:MM:SS±HH:MM**(timezone info is optional), valid values are between 7th January 1991 and midnight of tomorrow. Defaults to 7 days ago UTC."},{"name":"end_time","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"End time on format **yyyy-mm-ddTHH:MM:SS±HH:MM**(timezone info is optional), valid values are between 7th January 1991 and midnight of tomorrow. Defaults to the current time UTC.","title":"End Time"},"description":"End time on format **yyyy-mm-ddTHH:MM:SS±HH:MM**(timezone info is optional), valid values are between 7th January 1991 and midnight of tomorrow. Defaults to the current time UTC."},{"name":"depth_min","in":"query","required":false,"schema":{"type":"number","maximum":50,"minimum":0,"description":"Minimum depth in kilometers.","default":0,"title":"Depth Min"},"description":"Minimum depth in kilometers."},{"name":"depth_max","in":"query","required":false,"schema":{"type":"number","maximum":50,"minimum":0,"description":"Maximum depth in kilometers.","default":50,"title":"Depth Max"},"description":"Maximum depth in kilometers."},{"name":"size_min","in":"query","required":false,"schema":{"type":"number","maximum":10,"minimum":-3,"description":"Minimum size in moment magnitude.","default":-3,"title":"Size Min"},"description":"Minimum size in moment magnitude."},{"name":"size_max","in":"query","required":false,"schema":{"type":"number","maximum":10,"minimum":-3,"description":"Maximum size in moment magnitude.","default":7,"title":"Size Max"},"description":"Maximum size in moment magnitude."},{"name":"polygon","in":"query","required":false,"schema":{"type":"string","description":"Coordinates as a Well Known Text (wkt) polygon.","default":"POLYGON((-32.29664 72.44958, -32.29664 52.79541, 15.56576 52.79541, 15.56576 72.44958, -32.29664 72.44958))","title":"Polygon"},"description":"Coordinates as a Well Known Text (wkt) polygon."},{"name":"type","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"enum":["earthquake","explosion","not locatable","not existing","other"],"type":"string"}},{"type":"null"}],"description":"Event type. Only applicable to events with evaluation_mode='manual'. 'other' event type is not an actual type, but encompasses any types that are not part of this list.","title":"Type"},"description":"Event type. Only applicable to events with evaluation_mode='manual'. 'other' event type is not an actual type, but encompasses any types that are not part of this list."},{"name":"evaluation_mode","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"enum":["manual","automatic"],"type":"string"}},{"type":"null"}],"description":"Evaluation mode, can be either 'manual' or 'automatic'. If not sent, gets all evaluation modes.","title":"Evaluation Mode"},"description":"Evaluation mode, can be either 'manual' or 'automatic'. If not sent, gets all evaluation modes."},{"name":"format","in":"query","required":false,"schema":{"enum":["csv","json"],"type":"string","description":"The format of the output.","default":"json","title":"Format"},"description":"The format of the output."},{"name":"system","in":"query","required":false,"schema":{"enum":["sil","seiscomp"],"type":"string","description":"The underlying system from which the quakes are derived. SIL is a legacy system developed by the IMO and will eventually be phased out.","default":"seiscomp","title":"System"},"description":"The underlying system from which the quakes are derived. SIL is a legacy system developed by the IMO and will eventually be phased out."},{"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-08-06":{"summary":"2026-08-06","value":"2026-08-06"}}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"title":"Response Returns Quake Information As Geojson Or Csv  Events Get"}},"text/csv":{}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/events/count":{"get":{"tags":["Events"],"summary":"Return Number Of Events Given Provided Parameters.","operationId":"Return_number_of_events_given_provided_parameters__events_count_get","parameters":[{"name":"start_time","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Start time on format **yyyy-mm-ddTHH:MM:SS±HH:MM**(timezone info is optional), valid values are between 7th January 1991 and midnight of tomorrow. Defaults to 7 days ago UTC.","title":"Start Time"},"description":"Start time on format **yyyy-mm-ddTHH:MM:SS±HH:MM**(timezone info is optional), valid values are between 7th January 1991 and midnight of tomorrow. Defaults to 7 days ago UTC."},{"name":"end_time","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"End time on format **yyyy-mm-ddTHH:MM:SS±HH:MM**(timezone info is optional), valid values are between 7th January 1991 and midnight of tomorrow. Defaults to the current time UTC.","title":"End Time"},"description":"End time on format **yyyy-mm-ddTHH:MM:SS±HH:MM**(timezone info is optional), valid values are between 7th January 1991 and midnight of tomorrow. Defaults to the current time UTC."},{"name":"depth_min","in":"query","required":false,"schema":{"type":"number","maximum":50,"minimum":0,"description":"Minimum depth in kilometers.","default":0,"title":"Depth Min"},"description":"Minimum depth in kilometers."},{"name":"depth_max","in":"query","required":false,"schema":{"type":"number","maximum":50,"minimum":0,"description":"Maximum depth in kilometers.","default":50,"title":"Depth Max"},"description":"Maximum depth in kilometers."},{"name":"size_min","in":"query","required":false,"schema":{"type":"number","maximum":10,"minimum":-3,"description":"Minimum size in moment magnitude.","default":-3,"title":"Size Min"},"description":"Minimum size in moment magnitude."},{"name":"size_max","in":"query","required":false,"schema":{"type":"number","maximum":10,"minimum":-3,"description":"Maximum size in moment magnitude.","default":7,"title":"Size Max"},"description":"Maximum size in moment magnitude."},{"name":"polygon","in":"query","required":false,"schema":{"type":"string","description":"Coordinates as a Well Known Text (wkt) polygon.","default":"POLYGON((-32.29664 72.44958, -32.29664 52.79541, 15.56576 52.79541, 15.56576 72.44958, -32.29664 72.44958))","title":"Polygon"},"description":"Coordinates as a Well Known Text (wkt) polygon."},{"name":"type","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"enum":["earthquake","explosion","not locatable","not existing","other"],"type":"string"}},{"type":"null"}],"description":"Event type. Only applicable to events with evaluation_mode='manual'. 'other' event type is not an actual type, but encompasses any types that are not part of this list.","title":"Type"},"description":"Event type. Only applicable to events with evaluation_mode='manual'. 'other' event type is not an actual type, but encompasses any types that are not part of this list."},{"name":"evaluation_mode","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"enum":["manual","automatic"],"type":"string"}},{"type":"null"}],"description":"Evaluation mode, can be either 'manual' or 'automatic'. If not sent, gets all evaluation modes.","title":"Evaluation Mode"},"description":"Evaluation mode, can be either 'manual' or 'automatic'. If not sent, gets all evaluation modes."},{"name":"format","in":"query","required":false,"schema":{"enum":["csv","json"],"type":"string","description":"The format of the output.","default":"json","title":"Format"},"description":"The format of the output."},{"name":"system","in":"query","required":false,"schema":{"enum":["sil","seiscomp"],"type":"string","description":"The underlying system from which the quakes are derived. SIL is a legacy system developed by the IMO and will eventually be phased out.","default":"seiscomp","title":"System"},"description":"The underlying system from which the quakes are derived. SIL is a legacy system developed by the IMO and will eventually be phased out."},{"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-08-06":{"summary":"2026-08-06","value":"2026-08-06"}}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"integer","title":"Response Return Number Of Events Given Provided Parameters  Events Count Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/events/{event_id}":{"get":{"tags":["Events"],"summary":"Returns Detailed Information Given An Event Id.","operationId":"Returns_detailed_information_given_an_event_id__events__event_id__get","parameters":[{"name":"event_id","in":"path","required":true,"schema":{"type":"string","title":"Event Id"},"example":"IMO2025uutcxo"},{"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-08-06":{"summary":"2026-08-06","value":"2026-08-06"}}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"title":"Response Returns Detailed Information Given An Event Id  Events  Event Id  Get"}}}},"404":{"description":"Event not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/regions":{"get":{"tags":["Regions"],"summary":"Returns All Seismic Regions","operationId":"Returns_all_Seismic_regions_regions_get","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-08-06":{"summary":"2026-08-06","value":"2026-08-06"}}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/SeismicRegionList"},"title":"Response Returns All Seismic Regions Regions Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/regions/{id}":{"get":{"tags":["Regions"],"summary":"Returns Seismic Region By Id","operationId":"Returns_Seismic_region_by_id_regions__id__get","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","title":"Seismic region id","description":"The id within each type of seismic region, e.g. 5 for Grjótárvatn in Seismic Areas.","examples":[5]},"description":"The id within each type of seismic region, e.g. 5 for Grjótárvatn in Seismic Areas."},{"name":"type","in":"query","required":true,"schema":{"enum":["seismic_areas","seismic_fracture_zones","seismic_sil_alert_areas","seismic_zones"],"type":"string","title":"Type"}},{"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-08-06":{"summary":"2026-08-06","value":"2026-08-06"}}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SeismicRegion"}},"application/geo+json":{}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"Polygon":{"properties":{"type":{"type":"string","const":"Polygon","title":"Type"},"coordinates":{"items":{"items":{"prefixItems":[{"type":"number"},{"type":"number"}],"type":"array","maxItems":2,"minItems":2},"type":"array"},"type":"array","title":"Coordinates"}},"type":"object","required":["type","coordinates"],"title":"Polygon"},"SeismicRegion":{"properties":{"type":{"type":"string","const":"Feature","title":"Type"},"geometry":{"$ref":"#/components/schemas/Polygon"},"properties":{"$ref":"#/components/schemas/SeismicRegionProperties"}},"type":"object","required":["type","geometry","properties"],"title":"SeismicRegion"},"SeismicRegionList":{"properties":{"type":{"type":"string","const":"FeatureCollection","title":"Type"},"features":{"items":{"$ref":"#/components/schemas/SeismicRegion"},"type":"array","title":"Features"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["type","features","count"],"title":"SeismicRegionList"},"SeismicRegionProperties":{"properties":{"id":{"type":"integer","title":"Id"},"name":{"type":"string","title":"Name"},"name_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name En"},"comment":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Comment","default":"N/A"}},"type":"object","required":["id","name"],"title":"SeismicRegionProperties"},"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"}}},"servers":[{"url":"/quakes"}]}