Documentation

API Changelog

Version 3.0

March 1, 2020

Fixed bug that was preventing a query from showing open and closed events at the same time.

March 1, 2020

Launched stable version 3.0 of the API.

Version 3.0 (BETA)

January 28, 2020
/events & /events/geojson
Added the ability to filter on magnitudes and magnitude values
January 15, 2020
/events, /events/geojson & /categories
Swapped the ID from numeric to human readable ID. Numeric is still valid for queries
January 14, 2020
/events & /events/geojson
Added the ability to restrict results using a bounding box
/events/geojson
Added an array of dates (geometryDates) in the properties that correspoint with the points in the geometry
December 10, 2019

Significant updates including adding magnitude values and including a feed following the GeoJSON RFC 7946 standard.

/events
Updated empty values to display “null”
Made every property persistent for consistency
Renamed “geometries ”to “geometry” to align with GeoJSON spec
Added “magnitude value“, “magnitude unit“, “magnitude description“ to each geometry entry
/events/geojson
New feed with events organized per GeoJSON spec

Version 2.1

November 6, 2015

Bug fix update to Events output to address an incorrect formatting of GeoJSON polygon objects.

Version 2.0

January 19, 2021

Officially decommissioned.

October 19, 2015

We have made many edits to the API outputs, mostly to achieve consistency of field names, but since the changes are numerous and would break anything implemented using Version 1.0 we upped the version. Be sure to consult the Version 2.0 API for the latest names.

/events
Renamed “item ”to “events”
Renamed “reference ”to “sources”
Renamed “category ”to “categories”
Refactored individual categories to have both “id ”and “title"; removed “-domain ”and “#text"
Renamed “geometry ”to “geometries”
/types
Renamed this service endpoint to “/categories”
Renamed “item ”to “categories”
/topics
Renamed this service endpoint to “/categories”
/sources
Renamed “item ”to “sources”
/layers
New service providing mappings between categories (event types) and web service layers (image providers)

Version 1.0

July 2015

Our initial beta release.