v2.1 Documentation

V2.1 is the current version of the api. V2 is still available but should be considered deprecated and will be removed in the near future. To see what has changed from V2 to V2.1 please check out the changelog. There are also a few how-tos.

Below are descriptions of the data model fields and the API itself. Please note that all metadata contained within EONET is subject to our disclaimer.

Fields

Events

The Event object is returned within the Events API.

Name Description
id Unique id for this event.
title The title of the event.
description Optional longer description of the event. Most likely only a sentence or two.
link The full link to the API endpoint for this specific event.
categories One or more categories assigned to the event.
sources One or more sources that refer to more information about the event.
geometries One or more event geometries are the pairing of a specific date/time with a location. The date/time will most likely be 00:00Z unless a specific time was provided by the source. The geometry will be a GeoJSON object of either type “Point” or “Polygon.”
closed An event is deemed “closed” when it has ended. The closed field will include a date/time when the event has ended. Depending upon the nature of the event, the closed value may or may not accurately represent the absolute ending of the event.

Categories

Categories are the types of events by which individual events are cataloged. Categories can be used to filter the output of the Categories API and the Layers API. The acceptable categories can be accessed via the categories JSON.

Name Description
id Unique id for this category (integer).
title The title of the category.
description Longer description of the category, addressing the scope. Most likely only a sentence or two.
link The full link to the API endpoint for this specific category, which is the same as the Categories API endpoint filtered to return only events from this category.
layers A service endpoint that points to the Layers API endpoint filtered to return only layers from this category.

Sources

A Source is a reference(s) to further information about the event. These references are usually the source from which the event was first curated, although there can be multiple sources per event. Source(s) can be used to filter the output of the Events API. The acceptable sources can be accessed via the sources JSON.

Name Description
id Unique id for this type.
title The title of this source.
source The homepage url for the source.
link The full link to the API endpoint for this specific source, which is the same as the Events API endpoint only filtered to return only events from this source.

Layers

A Layer is a reference to a specific web service (e.g., WMS, WMTS) that can be used to produce imagery of a particular NASA data parameter. Layers are mapped to categories within EONET in order to provide a category-specific list of layers (e.g., the 'Volcanoes' category is mapped to layers that can provide imagery in true color, SO2, aerosols, etc.). Web services come in a variety of flavors so it is not possible to include all of the necessary metadata here that is required to construct a properly-formulated request (url). The full list of layers can be accessed via the layers JSON.

Name Description
name The name of the layer as specified by the source web service found at serviceUrl.
serviceUrl The base url of the web service.
serviceTypeId A string to indicate the type (WMS, WMTS, etc.) and version (1.0.0, 1.3.0, etc.) of the web service found at serviceUrl.
parameters Zero or more url parameters that are pertinent to the construction of a properly-formatted request to the web service found at serviceUrl.

API

Events

Parameter Value(s) Description Examples
https://eonet.sci.gsfc.nasa.gov/api/v2.1/events
source Source ID Filter the returned events by the Source. Multiple sources can be included in the parameter: comma separated, operates as a boolean OR. https://eonet.sci.gsfc.nasa.gov/api/v2.1/events?source=InciWeb
https://eonet.sci.gsfc.nasa.gov/api/v2.1/events?source=InciWeb,EO
status open | closed Events that have ended are assigned a closed date and the existence of that date will allow you to filter for only-open or only-closed events. Omitting the status parameter will return only the currently open events. https://eonet.sci.gsfc.nasa.gov/api/v2.1/events ?status=open
limit # Limits the number of events returned https://eonet.sci.gsfc.nasa.gov/api/v2.1/events?limit=5
days # Limit the number of prior days (including today) from which events will be returned. https://eonet.sci.gsfc.nasa.gov/api/v2.1/events?days=20
Example: https://eonet.sci.gsfc.nasa.gov/api/v2.1/events ?limit=5&days=20&source=InciWeb&status=open = Return the most recent 5 events within the past 20 days that have an InciWeb source and are open (still active events).

Categories

Parameter Value(s) Description Examples
https://eonet.sci.gsfc.nasa.gov/api/v2.1/categories
Category ID Filter the events by the Category. https://eonet.sci.gsfc.nasa.gov/api/v2.1/categories/8
https://eonet.sci.gsfc.nasa.gov/api/v2.1/categories/14
source Source ID Filter the topically-constrained events by the Source. Multiple sources can be included in the parameter: comma separated, operates as a boolean OR. https://eonet.sci.gsfc.nasa.gov/api/v2.1/categories /8?source=InciWeb
https://eonet.sci.gsfc.nasa.gov/api/v2.1/categories /14?source=InciWeb,EO
status open | closed Events that have ended are assigned a closed date and the existence of that date will allow you to filter for only-open or only-closed events. Omitting the status parameter will return only the currently open events. https://eonet.sci.gsfc.nasa.gov/api/v2.1/categories /8?status=open
limit # Limits the number of events returned https://eonet.sci.gsfc.nasa.gov/api/v2.1/categories /8?limit=5
days # Limit the number of prior days (including today) from which events will be returned. https://eonet.sci.gsfc.nasa.gov/api/v2.1/categories /8?days=20

Layers