Endpoint: tropicalcyclones

The tropical cyclones endpoint provides access to information on the active tropical cyclones, such as invests, tropical depressions, tropical storms, hurricanes, and typhoons, across the globe. Includes information on an individual storm’s name, position, historical track, and forecasts. The tropical API information is based on data from the National Hurricane Center (NHC), Central Pacific Hurricane Center (CPHC), and Joint Typhoon Warning Center (JTWC).

Use our wizard to try out this endpoint

Base URL Path	`https://api.aerisapi.com/tropicalcyclones/`
Data Coverage	Global
Included With	API, Flex
Update Interval	Every 6 hours; NHC storms up to 1-3 hours near landfall

Supported Actions

The following actions are supported with the tropicalcyclones endpoint:

:all	Currently only used for the /tropicalcyclones endpoint. This action is not added to the query. Instead, when this action is an option you would remit the action from your query altogether. For example, you can query all tropical cyclones by passing the following: `/tropicalcyclones?`
closest	The closest action will query the API for data that is closest to the requested place and return the results, if any, in order from closest to farthest. If no limit is provided in the request, then only the closest single result will be returned. If your request does not return results, you may try setting or increasing the radius being used.
search	The search action is used as a more general query method and expects the query to be defined with the custom query for the request. Unlike the closest action, results will not be returned in any particular order.
within	The within action allows for returning data within a variety of different geometrical regions. Currently supported geometries include a circle (requires a center point and radius), rectangle (requires two coordinate points defining the top-left and bottom-right corners) and polygon (requires at least three coordinate points). Unlike the closest action, the results will not be returned in any particular order based on distance.
affects	The affects action requests all places affected by a particular type of event, such as earthquake or storm cell. The query for places affected is unique for each endpoint it belongs to and can be a polygon (e.g., storm cell forecasts or warnings) or a circle with the center being the location of the event (e.g., earthquakes or fires). Instead of returning an array of objects specific to the endpoint, the affects action will always return an array of place objects in the same format as the within action on the places endpoint. Note: Not all endpoints support this action, so refer to each endpoint's complete documentation to determine if supported and its usage.

Supported Parameters

The following parameters are optional unless otherwise noted:

p	`p=:place`	Defines the location to query data for. Refer to the list of supported place value formats.
fields	`fields=:string`	Provides a comma separated list of values for the API to return. This parameter is often used to limit the amount of data returned. See Reducing Output.
filter	`filter=:string`	Predefined filters for limiting the results. The filter value can be a single, comma-delimited or a semicolon delimited string of filter names.
format	`format=:string`	Defines the API output format. The available options include: `format=json` - Standard JSON output. This is the default. `format=geojson` - API will output GeoJSON. If obtaining GeoJSON and using the fields parameter, be sure to include `loc` to ensure geographical references are available in the response.
limit	`limit=:total`	The total number of results to return as an integer. Each endpoint may have a set maximum for this value depending on usage. The default limit is 1 if not specified. The maximum limit for this endpoint is 50.
query	`query=:string`	Used to filter results based on certain fields in the data set. See Advanced Queries for more details.
radius	`radius=:distance:unit`	When requesting the closest results within a circle, the radius determines how far from the specified location to search. A valid unit value must be included in your radius value, e.g., "5mi", "10km", "25miles". If no unit is provided, your value is assumed to be in meters by default. Most endpoints utilize a default radius of 50 miles, though some endpoints, such as lightning, may have tighter restrictions specified.
minradius	`minradius=:distance:unit`	When requesting the closest results within a circle, the minradius determines how far from the specified location to search to begin searching results. A valid unit value must be included in your minimum radius value, e.g., "5mi", "10km", or "25miles". If no unit is provided, your value is assumed to be in meters by default. When combined with the radius parameter, donut style queries can be made for point data, such as lightning.
skip	`skip=:number`	Used to skip over a specific number of results in the data set.
sort	`sort=:string`	Used to sort results based on certain fields in the data set. See Sorting for more details.

Supported Filters

The following filters can be passed to the filter parameter to reduce the results that are returned:

atlantic	Return tropical systems within the Atlantic basin
al	Alias for atlantic
eastpacific	Return tropical systems within the Eastern Pacific basin
ep	Alias for eastpacific
centralpacific	Return tropical systems within the Central Pacific basin
cp	Alias for centralpacific
westpacific	Return tropical systems within the Western Pacific basin
wp	Alias for westpacific
pacific	Return tropical systems within the Eastern, Central and Western Pacific basins
indian	Return tropical systems within the Indian Ocean basin
io	Alias for indianocean
southern	Return tropical systems within the Southern Hemisphere basin
sh	Alias for southernhemisphere
position	Used when searching by location, closest and within actions. Search based on system current position (This is the default behavior)
track	Used when searching by location, closest and within actions. Search based on system historical track
forecast	Used when searching by location, closest and within actions. Search based on system forecast track
windfield	Used to force the API to return the 34, 50 and 64 knot wind field polygons for the current position and forecast position of active tropical cyclones.
geo	Used to force the API to return the error cone when available. By default the API does not return the error cone due to the large amount of data.
test	Return Test storm information, useful for development and demonstration
invests	Return information on active invests. Invests are areas under INVESTigation for potential future tropical development.
dateline	When combined with format=geojson, the API will split any polygons into split error cones and line strings into separate features at the anti-merdian / dateline.

Supported Query Properties

Use the following supported property keys when creating custom queries for your requests:

id	Query based on the storm ID. The storm ID will be similar too: 2017-AL-16 or YEAR-BASIN-EVENTNUMBER
basin	Query the storm basin two letter abbreviation: AL = Atlantic EP = Eastern Pacific CP = Central Pacific WP = Western Pacific IO = Indian Ocean SH = Southern Hemisphere
origin	Query the two letter basin abbreviation the storm originated in. See Basin for the potential availables.
currentbasin	Query the two letter basin abbreviation that the storm is currently within. See Basin for the potential availables.
year	Query based on the year of the tropical season the tropical system initiated.
event	Query based on the event number of the tropical system. The event number will start at 1 for each basin and increase consecutively with each tropical system within that basin.
name	Query based on the tropical system name, without the storm type. For example for Hurricane Nate, you would use query=name:nate
startdate	Query based on the date and time the tropical system was initialized and the first advisory issued by the NHC or JWTC.
enddate	Query based on the date and time that the tropical system was deactivated. This will be the date and time of the final advisory issued by the NHC or JWTC.
maxtype	Query based on the maximum storm type: I = Invest* WV = Tropical Wave LO = Low Pressure System** TD = Tropical Depression TS = Tropical Storm H = Hurricane TY = Typhoon * Only seen when passing `filter=invests` ** Only seen as max when passing `filter=invests`. Possible to be seen in previous track, but will not be max for a named storm.
maxcat	Query based on the maximum category of the storm: I = Invest* WV = Tropical Wave LO = Low Pressure System** TD = Tropical Depression TS = Tropical Storm H1 = Category 1 Hurricane H2 = Category 2 Hurricane H3 = Category 3 Hurricane H4 = Category 4 Hurricane H5 = Category 5 Hurricane TY = Typhoon STY = Super Typhoon * Only seen when passing `filter=invests` ** Only seen as max when passing `filter=invests`. Possible to be seen in previous track, but will not be max for a named storm.
maxwindspeed	Query based on the maximum wind speed, in knots, observed for the system, as reported by the NHC or JWTC.
minpressure	Query based on the minimum pressure, in millibars, observed for the system, as reported by the NHC or JWTC.
test	Query based on if the system is a test storm for development purposes. true = A test tropical system false = An actual tropical system
stormtype	Query based on current storm type (see maxtype codes) for currently active storms.
stormcat	Query based on current storm strength category (see maxcat codes) for currently active storms.
windspeed	Query based on current sustained wind speed, in knots, for currently active storms.
pressure	Query based on current pressure, in millibars, for currently active storms.
stormdir	Query based on current storm direction, in degrees, for currently active storms.
stormspeed	Query based on current storm speed, in knots, for currently active storms.
trackstormtype	Query based on storm type within the historical track of a storm. See maxtype codes.
trackstormcat	Query based on storm category within the historical track of a storm. See maxcat codes.
trackwindspeed	Query based on the wind speed, in knots, within the historical track of a storm
trackpressure	Query based on the pressure, in millibars, within the historical track of a storm
trackstormdir	Query based on the storm direction, in degrees, within the historical track of a storm
trackstormspeed	Query based on the storm speed, in knots, within the historical track of a storm
fcststormtype	Query based on the forecast storm type for currently active storms. See maxtype codes.
fcststormcat	Query based on the forecast storm strength category for currently active storms. See maxcat codes.
fcstwindspeed	Query based on the forecast sustained wind speed, in knots, for currently active storms.

Examples

The /[:endpoint]/[:action]? portion within the query template below can be exchanged with any of the examples. Also, please note you will need to input your client credentials in the [ID] and [SECRET] fields which can be found under the Apps section of the members area.

https://api.aerisapi.com/[:endpoint]/[:action]?client_id=[ID]&client_secret=[SECRET]

Return the currently active tropical systems
/tropicalcyclones?

Return the currently active tropical systems within the Atlantic basin
/tropicalcyclones?filter=al&

Return the currently active tropical cyclones that are in the atlantic or eastern pacific or the central pacific basins. Note that a semicolon separator is used to denote a logical OR.
/tropicalcyclones?filter=al;ep;cp&

Return the currently active tropical systems within the Atlantic basin and include the error cone information.
/tropicalcyclones?filter=al&filter=geo&

Return information on tropical system with ID 2017-AL-16 (Hurricane Nate)
/tropicalcyclones/2017-AL-16?

Return information on currently active tropical systems that are currently located within 300 miles of Miami, Florida
/tropicalcyclones/miami,fl?radius=300miles&

Return information on the active Invests. Invests are areas under investigation for potential future tropical development.
/tropicalcyclones/?filter=invests&

Return information on the active Invests within the atlantic.
/tropicalcyclones/?filter=invests,al&

Response

The following is an example of what each object in the response will consist of. Depending on your requested action, the response may contain multiple instances of this object within an array.


{
    "id": "2018-AL-03",
    "profile": {
        "name": "CHRIS",
        "year": 2018,
        "basin": "AL",
        "event": 3,
        "isActive": true,
        "lifespan": {
            "startTimestamp": 1530910800,
            "startDateTimeISO": "2018-07-06T21:00:00+00:00",
            "endTimestamp": null,
            "endDateTimeISO": null
        },
        "maxStormType": "TS",
        "maxStormCat": "TS",
        "windSpeed": {
            "maxKTS": 60.7,
            "maxKPH": 112,
            "maxMPH": 70,
            "maxTimestamp": 1531170000,
            "maxDateTimeISO": "2018-07-09T21:00:00+00:00"
        },
        "pressure": {
            "minMB": 993,
            "minIN": 29.32,
            "minTimestamp": 1531213200,
            "minDateTimeISO": "2018-07-10T09:00:00+00:00"
        },
        "boundingBox": [32.2, -75.5, 54, -18]
    },
    "position": {
        "location": {
            "type": "Point",
            "coordinates": [-73.1, 33.1]
        },
        "details": {
            "stormType": "TS",
            "stormCat": "TS",
            "stormName": "TROPICAL STORM CHRIS",
            "advisoryNumber": "16",
            "movement": {
                "directionDEG": 45,
                "direction": "NE",
                "speedKTS": 7.8,
                "speedKPH": 14,
                "speedMPH": 9
            },
            "windSpeedKTS": 60.7,
            "windSpeedKPH": 112,
            "windSpeedMPH": 70,
            "gustSpeedKTS": null,
            "gustSpeedKPH": null,
            "gustSpeedMPH": null,
            "pressureMB": 993,
            "pressureIN": 29.32
        },
        "timestamp": 1531234800,
        "dateTimeISO": "2018-07-10T15:00:00+00:00"
    },
    "track": [{
        "location": {
            "type": "Point",
            "coordinates": [-73.8, 32.2]
        },
        "details": {
            "stormType": "TD",
            "stormCat": "TD",
            "stormName": "TROPICAL DEPRESSION THREE",
            "advisoryNumber": "1",
            "movement": {
                "directionDEG": 337.5,
                "direction": "NNW",
                "speedKTS": 4.3,
                "speedKPH": 8,
                "speedMPH": 5
            },
            "windSpeedKTS": 26,
            "windSpeedKPH": 48,
            "windSpeedMPH": 30,
            "gustSpeedKTS": null,
            "gustSpeedKPH": null,
            "gustSpeedMPH": null,
            "pressureMB": 1016,
            "pressureIN": 30
        },
        "timestamp": 1530910800,
        "dateTimeISO": "2018-07-06T21:00:00+00:00"
    }, {
        "location": {
            "type": "Point",
            "coordinates": [-74.1, 32.6]
        },
        "details": {
            "stormType": "TD",
            "stormCat": "TD",
            "stormName": "TROPICAL DEPRESSION THREE",
            "advisoryNumber": "2",
            "movement": {
                "directionDEG": 337.5,
                "direction": "NNW",
                "speedKTS": 5.2,
                "speedKPH": 10,
                "speedMPH": 6
            },
            "windSpeedKTS": 26,
            "windSpeedKPH": 48,
            "windSpeedMPH": 30,
            "gustSpeedKTS": null,
            "gustSpeedKPH": null,
            "gustSpeedMPH": null,
            "pressureMB": 1015,
            "pressureIN": 29.97
        },
        "timestamp": 1530932400,
        "dateTimeISO": "2018-07-07T03:00:00+00:00"
    }, {
        "location": {
            "type": "Point",
            "coordinates": [-74.6, 33.2]
        },
        "details": {
            "stormType": "TD",
            "stormCat": "TD",
            "stormName": "TROPICAL DEPRESSION THREE",
            "advisoryNumber": "3",
            "movement": {
                "directionDEG": 337.5,
                "direction": "NNW",
                "speedKTS": 4.3,
                "speedKPH": 8,
                "speedMPH": 5
            },
            "windSpeedKTS": 26,
            "windSpeedKPH": 48,
            "windSpeedMPH": 30,
            "gustSpeedKTS": null,
            "gustSpeedKPH": null,
            "gustSpeedMPH": null,
            "pressureMB": 1015,
            "pressureIN": 29.97
        },
        "timestamp": 1530954000,
        "dateTimeISO": "2018-07-07T09:00:00+00:00"
    }, {
        "location": {
            "type": "Point",
            "coordinates": [-74.8, 33.1]
        },
        "details": {
            "stormType": "TD",
            "stormCat": "TD",
            "stormName": "TROPICAL DEPRESSION THREE",
            "advisoryNumber": "4",
            "movement": {
                "directionDEG": 0,
                "direction": "N",
                "speedKTS": 1.7,
                "speedKPH": 3,
                "speedMPH": 2
            },
            "windSpeedKTS": 26,
            "windSpeedKPH": 48,
            "windSpeedMPH": 30,
            "gustSpeedKTS": null,
            "gustSpeedKPH": null,
            "gustSpeedMPH": null,
            "pressureMB": 1015,
            "pressureIN": 29.97
        },
        "timestamp": 1530975600,
        "dateTimeISO": "2018-07-07T15:00:00+00:00"
    }, {
        "location": {
            "type": "Point",
            "coordinates": [-75.3, 32.9]
        },
        "details": {
            "stormType": "TD",
            "stormCat": "TD",
            "stormName": "TROPICAL DEPRESSION THREE",
            "advisoryNumber": "5",
            "movement": {
                "direction": null,
                "directionDEG": null,
                "speedKTS": 0,
                "speedKPH": 0,
                "speedMPH": 0
            },
            "windSpeedKTS": 30.3,
            "windSpeedKPH": 56,
            "windSpeedMPH": 35,
            "gustSpeedKTS": null,
            "gustSpeedKPH": null,
            "gustSpeedMPH": null,
            "pressureMB": 1014,
            "pressureIN": 29.94
        },
        "timestamp": 1530997200,
        "dateTimeISO": "2018-07-07T21:00:00+00:00"
    }, {
        "location": {
            "type": "Point",
            "coordinates": [-75.1, 32.9]
        },
        "details": {
            "stormType": "TD",
            "stormCat": "TD",
            "stormName": "TROPICAL DEPRESSION THREE",
            "advisoryNumber": "6",
            "movement": {
                "direction": null,
                "directionDEG": null,
                "speedKTS": 0,
                "speedKPH": 0,
                "speedMPH": 0
            },
            "windSpeedKTS": 30.3,
            "windSpeedKPH": 56,
            "windSpeedMPH": 35,
            "gustSpeedKTS": null,
            "gustSpeedKPH": null,
            "gustSpeedMPH": null,
            "pressureMB": 1014,
            "pressureIN": 29.94
        },
        "timestamp": 1531018800,
        "dateTimeISO": "2018-07-08T03:00:00+00:00"
    }, {
        "location": {
            "type": "Point",
            "coordinates": [-75.5, 33]
        },
        "details": {
            "stormType": "TS",
            "stormCat": "TS",
            "stormName": "TROPICAL STORM CHRIS",
            "advisoryNumber": "7",
            "movement": {
                "direction": null,
                "directionDEG": null,
                "speedKTS": 0,
                "speedKPH": 0,
                "speedMPH": 0
            },
            "windSpeedKTS": 34.7,
            "windSpeedKPH": 64,
            "windSpeedMPH": 40,
            "gustSpeedKTS": null,
            "gustSpeedKPH": null,
            "gustSpeedMPH": null,
            "pressureMB": 1010,
            "pressureIN": 29.83
        },
        "timestamp": 1531040400,
        "dateTimeISO": "2018-07-08T09:00:00+00:00"
    }, {
        "location": {
            "type": "Point",
            "coordinates": [-75, 32.9]
        },
        "details": {
            "stormType": "TS",
            "stormCat": "TS",
            "stormName": "TROPICAL STORM CHRIS",
            "advisoryNumber": "8",
            "movement": {
                "direction": null,
                "directionDEG": null,
                "speedKTS": 0,
                "speedKPH": 0,
                "speedMPH": 0
            },
            "windSpeedKTS": 39,
            "windSpeedKPH": 72,
            "windSpeedMPH": 45,
            "gustSpeedKTS": null,
            "gustSpeedKPH": null,
            "gustSpeedMPH": null,
            "pressureMB": 1006,
            "pressureIN": 29.71
        },
        "timestamp": 1531062000,
        "dateTimeISO": "2018-07-08T15:00:00+00:00"
    }, {
        "location": {
            "type": "Point",
            "coordinates": [-74.6, 32.7]
        },
        "details": {
            "stormType": "TS",
            "stormCat": "TS",
            "stormName": "TROPICAL STORM CHRIS",
            "advisoryNumber": "9",
            "movement": {
                "direction": null,
                "directionDEG": null,
                "speedKTS": 0,
                "speedKPH": 0,
                "speedMPH": 0
            },
            "windSpeedKTS": 43.4,
            "windSpeedKPH": 80,
            "windSpeedMPH": 50,
            "gustSpeedKTS": null,
            "gustSpeedKPH": null,
            "gustSpeedMPH": null,
            "pressureMB": 1008,
            "pressureIN": 29.77
        },
        "timestamp": 1531083600,
        "dateTimeISO": "2018-07-08T21:00:00+00:00"
    }, {
        "location": {
            "type": "Point",
            "coordinates": [-74.5, 32.5]
        },
        "details": {
            "stormType": "TS",
            "stormCat": "TS",
            "stormName": "TROPICAL STORM CHRIS",
            "advisoryNumber": "10",
            "movement": {
                "directionDEG": 112.5,
                "direction": "ESE",
                "speedKTS": 1.7,
                "speedKPH": 3,
                "speedMPH": 2
            },
            "windSpeedKTS": 52.1,
            "windSpeedKPH": 96,
            "windSpeedMPH": 60,
            "gustSpeedKTS": null,
            "gustSpeedKPH": null,
            "gustSpeedMPH": null,
            "pressureMB": 1005,
            "pressureIN": 29.68
        },
        "timestamp": 1531105200,
        "dateTimeISO": "2018-07-09T03:00:00+00:00"
    }, {
        "location": {
            "type": "Point",
            "coordinates": [-74.6, 32.4]
        },
        "details": {
            "stormType": "TS",
            "stormCat": "TS",
            "stormName": "TROPICAL STORM CHRIS",
            "advisoryNumber": "11",
            "movement": {
                "directionDEG": 180,
                "direction": "S",
                "speedKTS": 0.8,
                "speedKPH": 1,
                "speedMPH": 1
            },
            "windSpeedKTS": 52.1,
            "windSpeedKPH": 96,
            "windSpeedMPH": 60,
            "gustSpeedKTS": null,
            "gustSpeedKPH": null,
            "gustSpeedMPH": null,
            "pressureMB": 999,
            "pressureIN": 29.5
        },
        "timestamp": 1531126800,
        "dateTimeISO": "2018-07-09T09:00:00+00:00"
    }, {
        "location": {
            "type": "Point",
            "coordinates": [-74.5, 32.2]
        },
        "details": {
            "stormType": "TS",
            "stormCat": "TS",
            "stormName": "TROPICAL STORM CHRIS",
            "advisoryNumber": "12",
            "movement": {
                "direction": null,
                "directionDEG": null,
                "speedKTS": 0,
                "speedKPH": 0,
                "speedMPH": 0
            },
            "windSpeedKTS": 52.1,
            "windSpeedKPH": 96,
            "windSpeedMPH": 60,
            "gustSpeedKTS": null,
            "gustSpeedKPH": null,
            "gustSpeedMPH": null,
            "pressureMB": 999,
            "pressureIN": 29.5
        },
        "timestamp": 1531148400,
        "dateTimeISO": "2018-07-09T15:00:00+00:00"
    }, {
        "location": {
            "type": "Point",
            "coordinates": [-74.4, 32.2]
        },
        "details": {
            "stormType": "TS",
            "stormCat": "TS",
            "stormName": "TROPICAL STORM CHRIS",
            "advisoryNumber": "13",
            "movement": {
                "direction": null,
                "directionDEG": null,
                "speedKTS": 0,
                "speedKPH": 0,
                "speedMPH": 0
            },
            "windSpeedKTS": 60.7,
            "windSpeedKPH": 112,
            "windSpeedMPH": 70,
            "gustSpeedKTS": null,
            "gustSpeedKPH": null,
            "gustSpeedMPH": null,
            "pressureMB": 996,
            "pressureIN": 29.41
        },
        "timestamp": 1531170000,
        "dateTimeISO": "2018-07-09T21:00:00+00:00"
    }, {
        "location": {
            "type": "Point",
            "coordinates": [-74.3, 32.3]
        },
        "details": {
            "stormType": "TS",
            "stormCat": "TS",
            "stormName": "TROPICAL STORM CHRIS",
            "advisoryNumber": "14",
            "movement": {
                "direction": null,
                "directionDEG": null,
                "speedKTS": 0,
                "speedKPH": 0,
                "speedMPH": 0
            },
            "windSpeedKTS": 60.7,
            "windSpeedKPH": 112,
            "windSpeedMPH": 70,
            "gustSpeedKTS": null,
            "gustSpeedKPH": null,
            "gustSpeedMPH": null,
            "pressureMB": 995,
            "pressureIN": 29.38
        },
        "timestamp": 1531191600,
        "dateTimeISO": "2018-07-10T03:00:00+00:00"
    }, {
        "location": {
            "type": "Point",
            "coordinates": [-73.9, 32.6]
        },
        "details": {
            "stormType": "TS",
            "stormCat": "TS",
            "stormName": "TROPICAL STORM CHRIS",
            "advisoryNumber": "15",
            "movement": {
                "directionDEG": 45,
                "direction": "NE",
                "speedKTS": 1.7,
                "speedKPH": 3,
                "speedMPH": 2
            },
            "windSpeedKTS": 60.7,
            "windSpeedKPH": 112,
            "windSpeedMPH": 70,
            "gustSpeedKTS": null,
            "gustSpeedKPH": null,
            "gustSpeedMPH": null,
            "pressureMB": 993,
            "pressureIN": 29.32
        },
        "timestamp": 1531213200,
        "dateTimeISO": "2018-07-10T09:00:00+00:00"
    }, {
        "location": {
            "type": "Point",
            "coordinates": [-73.1, 33.1]
        },
        "details": {
            "stormType": "TS",
            "stormCat": "TS",
            "stormName": "TROPICAL STORM CHRIS",
            "advisoryNumber": "16",
            "movement": {
                "directionDEG": 45,
                "direction": "NE",
                "speedKTS": 7.8,
                "speedKPH": 14,
                "speedMPH": 9
            },
            "windSpeedKTS": 60.7,
            "windSpeedKPH": 112,
            "windSpeedMPH": 70,
            "gustSpeedKTS": null,
            "gustSpeedKPH": null,
            "gustSpeedMPH": null,
            "pressureMB": 993,
            "pressureIN": 29.32
        },
        "timestamp": 1531234800,
        "dateTimeISO": "2018-07-10T15:00:00+00:00"
    }],
    "forecast": [{
        "location": {
            "type": "Point",
            "coordinates": [-71.9, 33.9]
        },
        "details": {
            "stormType": "H",
            "stormCat": "H1",
            "stormName": "HURRICANE CHRIS",
            "advisoryNumber": "16",
            "pressure": null,
            "movement": null,
            "windSpeedKTS": 70,
            "windSpeedKPH": 130,
            "windSpeedMPH": 81,
            "gustSpeedKTS": 85,
            "gustSpeedKPH": 157,
            "gustSpeedMPH": 98
        },
        "timestamp": 1531267200,
        "dateTimeISO": "2018-07-11T00:00:00+00:00"
    }, {
        "location": {
            "type": "Point",
            "coordinates": [-69.4, 35.6]
        },
        "details": {
            "stormType": "H",
            "stormCat": "H1",
            "stormName": "HURRICANE CHRIS",
            "advisoryNumber": "16",
            "pressure": null,
            "movement": null,
            "windSpeedKTS": 75,
            "windSpeedKPH": 139,
            "windSpeedMPH": 86,
            "gustSpeedKTS": 90,
            "gustSpeedKPH": 167,
            "gustSpeedMPH": 104
        },
        "timestamp": 1531310400,
        "dateTimeISO": "2018-07-11T12:00:00+00:00"
    }, {
        "location": {
            "type": "Point",
            "coordinates": [-65.5, 38.4]
        },
        "details": {
            "stormType": "H",
            "stormCat": "H1",
            "stormName": "HURRICANE CHRIS",
            "advisoryNumber": "16",
            "pressure": null,
            "movement": null,
            "windSpeedKTS": 75,
            "windSpeedKPH": 139,
            "windSpeedMPH": 86,
            "gustSpeedKTS": 90,
            "gustSpeedKPH": 167,
            "gustSpeedMPH": 104
        },
        "timestamp": 1531353600,
        "dateTimeISO": "2018-07-12T00:00:00+00:00"
    }, {
        "location": {
            "type": "Point",
            "coordinates": [-60.6, 42]
        },
        "details": {
            "stormType": "H",
            "stormCat": "H1",
            "stormName": "HURRICANE CHRIS",
            "advisoryNumber": "16",
            "pressure": null,
            "movement": null,
            "windSpeedKTS": 65,
            "windSpeedKPH": 120,
            "windSpeedMPH": 75,
            "gustSpeedKTS": 80,
            "gustSpeedKPH": 148,
            "gustSpeedMPH": 92
        },
        "timestamp": 1531396800,
        "dateTimeISO": "2018-07-12T12:00:00+00:00"
    }, {
        "location": {
            "type": "Point",
            "coordinates": [-49.3, 48.1]
        },
        "details": {
            "stormType": "TS",
            "stormCat": "TS",
            "stormName": "TROPICAL STORM CHRIS",
            "advisoryNumber": "16",
            "pressure": null,
            "movement": null,
            "windSpeedKTS": 50,
            "windSpeedKPH": 93,
            "windSpeedMPH": 58,
            "gustSpeedKTS": 60,
            "gustSpeedKPH": 111,
            "gustSpeedMPH": 69
        },
        "timestamp": 1531483200,
        "dateTimeISO": "2018-07-13T12:00:00+00:00"
    }, {
        "location": {
            "type": "Point",
            "coordinates": [-31.9, 52]
        },
        "details": {
            "stormType": "TS",
            "stormCat": "TS",
            "stormName": "TROPICAL STORM CHRIS",
            "advisoryNumber": "16",
            "pressure": null,
            "movement": null,
            "windSpeedKTS": 35,
            "windSpeedKPH": 65,
            "windSpeedMPH": 40,
            "gustSpeedKTS": 45,
            "gustSpeedKPH": 83,
            "gustSpeedMPH": 52
        },
        "timestamp": 1531569600,
        "dateTimeISO": "2018-07-14T12:00:00+00:00"
    }, {
        "location": {
            "type": "Point",
            "coordinates": [-18, 54]
        },
        "details": {
            "stormType": "TS",
            "stormCat": "TS",
            "stormName": "TROPICAL STORM CHRIS",
            "advisoryNumber": "16",
            "pressure": null,
            "movement": null,
            "windSpeedKTS": 35,
            "windSpeedKPH": 65,
            "windSpeedMPH": 40,
            "gustSpeedKTS": 45,
            "gustSpeedKPH": 83,
            "gustSpeedMPH": 52
        },
        "timestamp": 1531656000,
        "dateTimeISO": "2018-07-15T12:00:00+00:00"
    }],
    "breakPointAlerts": null,
    "errorCone": null
}

Response Properties

The following properties will be provided in every response object:

id	(string) The tropical system ID. The storm ID will be similar too: 2017-AL-16 : YEAR-BASIN-EVENTNUMBER
profile	(object)
profile.name	(string) The storm name without the leading storm type. For example, a value of Nate for Hurricane Nate. The name is in mixed case. If the storm has not been named yet, this may be a number, i.e. Tropical Depression 4 would have a name of Four.
profile.year	(number) The tropical season year that the storm initialized within.
profile.basinOrigin	(string) The basin abbreviation that the storm is originated within. AL = Atlantic EP = Eastern Pacific CP = Central Pacific WP = Western Pacific IO = Indian Ocean SH = Southern Hemisphere
profile.basinCurrent	(string) The basin abbreviation that the storm is currently within. Null if the storm is no longer active.
profile.basins	(array) An array of the basin abbreviations that the storm has been within. Some Pacific storms may cross multiple Pacific basins.
profile.event	(number) The event number of the storm within the basin.
profile.isActive	(boolean) True if the storm is active, false otherwise.
profile.lifespan	(object) Object containing the lifespan of the storm.
profile.lifespan.startTimestamp	(number) Unix timestamp of when the first advisory was issued for the storm by the NHC or JTWC.
profile.lifespan.startDateTimeISO	(string) ISO 8601 date of when the first advisory was issued for the storm by the NHC or JTWC.
profile.lifespan.endTimestamp	(number) Unix timestamp of when the last advisory was issued for the storm by the NHC or JTWC. If a system is still active, this value will be null.
profile.lifespan.endDateTimeISO	(string) ISO 8601 date of when the last advisory was issued for the storm by the NHC or JTWC. If a system is still active, this value will be null.
profile.maxStormType	(string) The maximum type of storm (based on wind speed), abbreviated TD = Tropical Depression TS = Tropical Storm H = Hurricane TY = Typhoon
profile.maxStormCat	(string) The maximum strength category the storm achieved, based on wind speed. TD = Tropical Depression TS = Tropical Storm H1 = Category 1 Hurricane H2 = Category 2 Hurricane H3 = Category 3 Hurricane H4 = Category 4 Hurricane H5 = Category 5 Hurricane TY = Typhoon STY = Super Typhoon
profile.windSpeed	(object) Object containing the maximum wind speed information
profile.windSpeed.maxKTS	(number) Maximum reported wind speed of the storm during its lifetime in knots.
profile.windSpeed.maxKPH	(number) Maximum reported wind speed of the storm during its lifetime in kilometers per hour.
profile.windSpeed.maxMPH	(number) Maximum reported wind speed of the storm during its lifetime in miles per hour.
profile.windSpeed.maxTimestamp	(number) Unix timestamp of the date/time of the reported maximum wind speed
profile.windSpeed.maxDateTimeISO	(string) ISO 8601 date of the date/time of the reported maximum wind speed
profile.pressure	(object) Object containing the minimum pressure information. NULL if not available. Note: Pressure information is currently not available for West Pacific, South Pacific and Indian Ocean tropical systems
profile.pressure.minMB	(number) The minimum reported pressure of the storm during its lifetime, in millibars. Null if pressure information is not available.
profile.pressure.minIN	(number) The minimum reported pressure of the storm during its lifetime, in inches of mercury. Null if pressure information is not available.
profile.pressure.minTimestamp	(number) Unix timestamp of the date/time of the reported minimum pressure. Null if pressure information is not available.
profile.pressureminDateTimeISO	(string) ISO 8601 date of the date/time of the reported minimum pressure. Null if pressure information is not available.
profile.boundingBox	(array) Array containing a bounding box of all the system components, including the track, forecast, error cone, and breakpoint alerts. The bounding box array follows the following order: [South Latitude, West Longitude, North Latitude, East Longitude] NOTE: for systems that cross the 180th meridian, it is possible for the west longitude to have a greater value than the east longitude.
profile.tz	(string) The timezone name for the cyclone. If the storm is active, it will be the timezone of its current position, otherwise the timezone of the cyclones first location.
position	(object) Object containing the latest storm position information. NULL for inactive storms.
position.timestamp	(number) Unix timestamp of the date/time of the advisory for this data set, as issued by the NHC or JTWC.
position.dateTimeISO	(string) ISO 8601 date of the date/time of the advisory for this data set, as issued by the NHC or JTWC.
position.location	(object) The GeoJSON point object of the location of the tropical system.
position.location.type	(number) The GeoJSON object type. Should always be set to Point
position.location.coordinates	(array) Array of the position, containing the longitude and latitude.
position.loc	(object) Object containing the classic API location format of the latest reported position of the cyclone.
position.loc.long	(number) The longitude of the latest reported position of the cyclone.
position.loc.lat	(number) The latitude of the latest reported position of the cyclone.
position.details	(number) Object containing the tropical system details.
position.details.stormType	(string) The current storm type. Uses the same codes as profile.maxStormType
position.details.stormCat	(string) The current storm strength category, based on wind speed. Uses the same codes as profile.maxStormCat
position.details.stormName	(string) The full name of the storm at the time of the advisory, based on wind speed. Example: Tropical Storm Lee
position.details.stormShortName	(string) The storm name without the leading storm type. For example, a value of Nate for Hurricane Nate. The name is in mixed case. If the storm has not been named yet, this may be a number, i.e. Tropical Depression 4 would have a name of Four.
position.details.advisoryNumber	(string) The latest advisory number that the position information is based on. NOTE: This value is a string, as the NHC will issue intermediate advisories for storms close to landfall. These intermediate advisories may include letters, such as an Advisory Number of 4A
position.details.basin	(string) The two letter abbreviation of the basin the storm is located within.
position.details.movement	(object) Object containing the movement information. NULL if movement information is not available.
position.details.movement.direction	(string) The direction the storm is moving in cardinal coordinates.
position.details.movement.directionDEG	(number) The direction the storm is moving in degrees, 0 to 360, with 0 being North.
position.details.movement.speedKTS	(number) The speed of the storm in knots.
position.details.movement.speedKPH	(number) The speed of the storm in kilometers per hour.
position.details.movement.speedMPH	(number) The speed of the storm in miles per hour.
position.details.windSpeedKTS	(number) The maximum sustained wind speed reported in the advisory in knots
position.details.windSpeedKPH	(number) The maximum sustained wind speed reported in the advisory in kilometers per second
position.details.windSpeedMPH	(number) The maximum sustained wind speed reported in the advisory in miles per hour
position.details.gustSpeedKTS	(number) The maximum wind gust speed as reported in the advisory in knots. NULL is not available.
position.details.gustSpeedKPH	(number) The maximum wind gust speed as reported in the advisory in kilometers per hour. NULL is not available.
position.details.gustSpeedMPH	(number) The maximum wind gust speed as reported in the advisory in miles per hour. NULL is not available.
position.details.pressureMB	(number) The minimum pressure reported in the advisory in millibars. NULL if not available. Note: Pressure information is currently not available for West Pacific, South Pacific and Indian Ocean tropical systems
position.details.pressureIN	(number) The minimum pressure reported in the advisory in inches of mercury. NULL if not available. Note: Pressure information is currently not available for West Pacific, South Pacific and Indian Ocean tropical systems
position.details.windRadii	(array) Array of wind radii information for the cyclones current position. Null if no wind radii information.
position.details.windRadii.#.windSpeedKTS	(number) The wind speed in knots the wind radii information is for. Normally, 34, 50 or 64 knots
position.details.windRadii.#.windSpeedKPH	(number) The wind speed in kilometers per hour the wind radii information is for.
position.details.windRadii.#.windSpeedMPH	(number) The wind speed in miles per hour that the wind radii information is for.
position.details.windRadii.#.quadrants	(object) Object of wind radii information. Separate objects for the 34, 50 and 64 knot wind radii information, as needed for the specific storm.
position.details.windRadii.#.quadrants.ne	(object) Object of the wind radii for the northeast quadrant.
position.details.windRadii.#.quadrants.ne.distanceKM	(number) The distance in kilometers the winds extend from the storm center to the north east quadrant.
position.details.windRadii.#.quadrants.ne.distanceMI	(number) The distance in statute miles the winds extend from the storm center to the north east quadrant.
position.details.windRadii.#.quadrants.ne.distanceNM	(number) The distance in nautical miles the winds extend from the storm center to the north east quadrant.
position.details.windRadii.#.quadrants.ne.loc	(object) Position object for the north east extent of the wind fields.
position.details.windRadii.#.quadrants.ne.loc.long	(number) The longitude of the position of the north east extent of the wind fields.
position.details.windRadii.#.quadrants.ne.loc.lat	(number) The latitude of the position of the north east extent of the wind fields.
position.details.windRadii.#.quadrants.se	(number) Object of the wind radii for the southeast quadrant.
position.details.windRadii.#.quadrants.se.distanceKM	(number) The distance in kilometers the winds extend from the storm center to the southeast quadrant.
position.details.windRadii.#.quadrants.se.distanceMI	(number) The distance in statute miles the winds extend from the storm center to the southeast quadrant.
position.details.windRadii.#.quadrants.se.distanceNM	(number) The distance in nautical miles the winds extend from the storm center to the southeast quadrant.
position.details.windRadii.#.quadrants.se.loc	(number) Position object for the southeast extent of the wind fields.
position.details.windRadii.#.quadrants.se.loc.long	(number) The longitude of the position of the southeast extent of the wind fields
position.details.windRadii.#.quadrants.se.loc.lat	(number) The latitude of the position of the southeast extent of the wind fields
position.details.windRadii.#.quadrants.sw	(number) Object of the wind radii for the southwest quadrant
position.details.windRadii.#.quadrants.sw.distanceKM	(number) The distance in kilometers the winds extend from the storm center to the southwest quadrant.
position.details.windRadii.#.quadrants.sw.distanceMI	(number) The distance in statute miles the winds extend from the storm center to the southwest quadrant.
position.details.windRadii.#.quadrants.sw.distanceNM	(number) The distance in nautical miles the winds extend from the storm center to the southwest quadrant.
position.details.windRadii.#.quadrants.sw.loc	(number) Position object for the southwest extent of the wind fields.
position.details.windRadii.#.quadrants.sw.loc.long	(number) The longitude of the position of the southwest extent of the wind fields
position.details.windRadii.#.quadrants.sw.loc.lat	(number) The latitude of the position of the southwest extent of the wind fields
position.details.windRadii.#.quadrants.nw	(number) Object of the wind radii for the northwest quadrant
position.details.windRadii.#.quadrants.nw.distanceKM	(number) The distance in kilometers the winds extend from the storm center to the northwest quadrant.
position.details.windRadii.#.quadrants.nw.distanceMI	(number) The distance in statute miles the winds extend from the storm center to the northwest quadrant.
position.details.windRadii.#.quadrants.nw.distanceNM	(number) The distance in nautical miles the winds extend from the storm center to the northwest quadrant.
position.details.windRadii.#.quadrants.nw.loc	(number) Position object for the northwest extent of the wind fields.
position.details.windRadii.#.quadrants.nw.loc.long	(number) The longitude of the position of the northwest extent of the wind fields
position.details.windRadii.#.quadrants.nw.loc.lat	(number) The latitude of the position of the northwest extent of the wind fields
psoition.details.windRadii.#.windField	(object) GeoJSON polygon of the forecast wind fields. Null if not available or if filter=windfields not passed.
track	(array) Array containing the historical track information. The track information is sorted descending.
track.#.timestamp	(number) Unix timestamp of the date/time of the advisory for this data set, as issued by the NHC or JTWC.
track.#.dateTimeISO	(string) ISO 8601 date of the date/time of the advisory for this data set, as issued by the NHC or JTWC.
track.#.location	(object) The GeoJSON point object of the location of the tropical system.
track.#.location.type	(string) The GeoJSON object type. Should always be set to Point
track.#.location.coordinates	(number) Array of the position, containing the longitude and latitude.
track.#.loc	(object) The classic API location object of the location of the tropical cyclone
track.#.loc.long	(number) The longitude of the location of the tropical cyclone.
track.#.loc.lat	(number) The latitude of the location of the tropical cyclone.
track.#.details	(object) Object containing the tropical system details.
track.#.details.stormType	(string) The storm type. Uses the same codes as profile.maxStormType
track.#.details.stormCat	(string) The storm strength category, based on wind speed. Uses the same codes as profile.maxStormCat
track.#.details.stormName	(string) The full name of the storm at the time of the advisory, based on wind speed. Example: Tropical Storm Lee
track.#.details.stormShortName	(string) The storm name without the leading storm type. For example, a value of Nate for Hurricane Nate. The name is in mixed case. If the storm has not been named yet, this may be a number, i.e. Tropical Depression 4 would have a name of Four.
track.#.details.advisoryNumber	(string) The advisory number that the information is based on.
track.#.details.basin	(string) The two letter abbreviation of the basin the storm is located within.
track.#.details.movement	(object) Object containing the movement information. NULL if movement information is not available.
track.#.details.movement.direction	(string) The direction the storm is moving in cardinal coordinates.
track.#.details.movement.directionDEG	(number) The direction the storm is moving in degrees, 0 to 360, with 0 being North.
track.#.details.movement.speedKTS	(number) The speed of the storm in knots.
track.#.details.movement.speedKPH	(number) The speed of the storm in kilometers per hour.
track.#.details.movement.speedMPH	(number) The speed of the storm in miles per hour.
track.#.details.windSpeedKTS	(number) The maximum sustained wind speed reported in the advisory in knots
track.#.details.windSpeedKPH	(number) The maximum sustained wind speed reported in the advisory in kilometers per second
track.#.details.windSpeedMPH	(number) The maximum sustained wind speed reported in the advisory in miles per hour
track.#.details.gustSpeedKTS	(number) The maximum wind gust speed as reported in the advisory in knots. NULL is not available.
track.#.details.gustSpeedKPH	(number) The maximum wind gust speed as reported in the advisory in kilometers per hour. NULL is not available.
track.#.details.gustSpeedMPH	(number) The maximum wind gust speed as reported in the advisory in miles per hour. NULL is not available.
track.#.details.pressureMB	(number) The minimum pressure reported in the advisory in millibars. NULL if not available. Note: Pressure information is currently not available for West Pacific, South Pacific and Indian Ocean tropical systems
track.#.details.pressureIN	(number) The minimum pressure reported in the advisory in inches of mercury. NULL if not available. Note: Pressure information is currently not available for West Pacific, South Pacific and Indian Ocean tropical systems
forecast	(array) Array containing the forecast information. The track information is sorted ascending. NULL if the storm is not active or the forecast is unavailable.
forecast.#.timestamp	(number) Unix timestamp of the date/time of the forecast point information.
forecast.#.dateTimeISO	(string)
forecast.#.location	(object) The GeoJSON point object of the forecast location of the tropical system
forecast.#.location.type	(string) The GeoJSON object type. Should always be set to Point
forecast.#.location.coordinates	(array) Array of the position, containing the longitude and latitude.
forecast.#.loc	(object) The classic API location object of the forecast location of the tropical cyclone
forecast.#.loc.long	(number) The longitude of the forecast location of the tropical cyclone
forecast.#.loc.lat	(number) The latitude of the forecast location of the tropical cyclone
forecast.#.details	(object) Object containing the tropical system forecast details.
forecast.#.details.stormType	(string) The storm type. Uses the same codes as profile.maxStormType
forecast.#.details.stormCat	(string) The storm strength category, based on wind speed. Uses the same codes as profile.maxStormCat
forecast.#.details.stormName	(string) The full name of the storm, based on the forecast wind speed. Example: Tropical Storm Lee
forecast.#.details.stormShortName	(string) The storm name without the leading storm type. For example, a value of Nate for Hurricane Nate. The name is in mixed case. If the storm has not been named yet, this may be a number, i.e. Tropical Depression 4 would have a name of Four.
forecast.#.details.basin	(string) The two letter abbreviation of the basin the storm will be located within.
forecast.#.details.windSpeedKTS	(number) The maximum forecast sustained wind speed in knots
forecast.#.details.windSpeedKPH	(number) The maximum forecast sustained wind speed in kilometers per second
forecast.#.details.windSpeedMPH	(number) The maximum forecast sustained wind speed in miles per hour
forecast.#.details.gustSpeedKTS	(number) The maximum forecast wind gust speed in knots. NULL if not available
forecast.#.details.gustSpeedKPH	(number) The maximum forecast wind gust speed in kilometers per hour. NULL if not available
forecast.#.details.gustSpeedMPH	(number) The maximum forecast wind gust speed in miles per hour. NULL if not available
forecast.#.details.windRadii	(array) The wind radii for the forecast point. Null if unavailable. See the properties for position.details.windRadii for the complete list of individual elements.
errorCone	(object) GeoJSON polygon object of the forecast error cone. NULL if the storm is not active, the forecast information is unavailable or if the geo filter not provided. NOTE: Due to the error cone containing a large amount of data, the cone is not returned by default. Use filter=geo to force the API to return the error cone.
errorCone.Type	(string) The GeoJSON object type. Should always be set to Polygon
errorCone.coordinates	(array) Array of the error cone polygon information.
breakPointAlerts	(array) An array of NHC issued warnings and watches along the coastlines. NULL if not available. Only available for the Atlantic and East Pacific basins. The breakpoint alerts are commonly used to draw lines along the coastlines. These should not be confused with the official tropical and hurricane-related alerts issued by the local National Weather Service offices.
breakPointAlerts.alertType	(string) The type of alert issued. TR.A = Tropical Storm Watch TR.W = Tropical Storm Warning HU.A = Hurricane Watch HU.W = Hurricane Warning
breakPointAlerts.coords	(object) GeoJSON LineString object of NHC issued breakpoint alerts along the coasts.
breakPointAlerts.coords.type	(string) The GeoJSON object type. Should always be set to LineString
breakPointAlerts.coords.coordinates	(array) Array of the LineString coordinates
relativeTo.lat	(number) Latitude coordinate of the location used for the request. This may be different than the record's loc.lat value if there was no record exactly at the request location.
relativeTo.long	(number) Longitude coordinate of the location used for the request. This may be different than the record's loc.long value if there was no record exactly at the request location.
relativeTo.bearing	(number) Bearing in degrees of the record's location relative to the location used for the request.
relativeTo.bearingEng	(string) Cardinal direction of the record relative to the location used for the request.
relativeTo.distanceKM	(number) Distance, in kilometers, from the requested location to the record's actual location.
relativeTo.distanceMI	(number) Distance, in miles, from the requested location to the record's actual location.

Last modified: September 18, 2023

AerisWeather API