Endpoint: tropicalcyclones/archive

The tropical cyclones archive endpoint provides access to archive information for global tropical cyclones, including tropical storms, hurricanes, and typhoons. This endpoint includes information on an individual storm’s name, historical track, and if active, its position and forecast information. Tropical archive information is based on data from the National Hurricane Center (NHC), Central Pacific Hurricane Center (CPHC), and Joint Typhoon Warning Center (JTWC). Archive information is available from 1851 for the Atlantic basin and the 1940s for the Pacific basins.

Supported Actions

The following actions are supported with the tropicalcyclones/archive endpoint:

:id Requesting data by using the :id action is used for returning data for a particular item that has an ID associated with it. This is the primary method for requesting general weather information for a single location (observations, forecasts, advisories, etc.) as the location's name or a zip code serves as the id. Other endpoints may expect a certain value for the ID, such as storm cells whose ID value is a combination of the radar site identifier and unique identifier assigned to every storm cell. Refer to an endpoint's detailed documentation for specific information regarding how to use the :id action.
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.
from from=:string Returns the results starting from the value specified. For best practices we recommend using the to parameter as well to define a specific time frame.

Supports a UNIX timestamp or a specific date string. Alternatively, common date formats supported by the PHP strtotime() function will be accepted; however, commas are not accepted.

Examples:
from=tomorrow
from=friday
from=1302883980
from=MM/DD/YYYY
from=YYYY/MM/DD
from=+2hours
from=2017-02-27 5:00 PM

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.
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.
to to=:string Returns the results between now and the value specified. For best practices we recommend using the from parameter as well to define a specific time frame. When used in conjunction with the from parameter, the value of to will be relative to the value of from, not relative to the current time.

Supports a UNIX timestamp or a specific date string. Alternatively, common date formats supported by the PHP strtotime() function will be accepted; however, commas are not accepted.

Examples:
to=+6hours
to=+5days
to=1302883980
to=MM/DD/YYYY
to=YYYY/MM/DD
to=2017-02-27 5:00 PM

Supported Filters

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

active Return information on active systems (Default)
notactive Return information on non active systems
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
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

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
active Query if the storm is active:
true = active
false = no active
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.
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:
WV = Tropical Wave
TD = Tropical Depression
TS = Tropical Storm
H = Hurricane
TY = Typhoon
maxcat Query based on the maximum category of the storm:
WV = Tropical Wave
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
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 up to 20 tropical cyclones that occurred in the Atlantic basin over the past year (the default if no from/to provided)
/tropicalcyclones/archive/search?filter=al&limit=20&

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

Return information on up to 10 tropical systems that tracked within 300 miles of Miami, FL over the past 5 years.
/tropicalcyclones/archive/miami,fl?radius=300miles&from=-5years&to=now&limit=10&

Return information on all tropical systems that the historic track came within 300 miles of Miami, Florida during the 1992 tropical season.
/tropicalcyclones/archive/miami,fl?radius=300miles&filter=track&query=year:1992:1992&

Return information on the tropical system that had the maximum winds reported in the 2017 tropical season, as reported by the NHC or JTWC.
/tropicalcyclones/archive/search?query=year:2017:2017&sort=maxwindspeed:-1&limit=1&

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],
        "testStorm": false
    },
    "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 location within. Null for inactive storms
profile.basins (array) Array of basin abbreviations that the storm has been within. Some Pacific storms may travel into multiple 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
I = Invest
DB = Disturbance
TD = Tropical Depression
TS = Tropical Storm
H = Hurricane
TY = Typhoon
profile.maxStormCat (string) The maximum strength category the storm achieved, based on wind speed.
I = Invest
DB = Disturbance
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) The classic API location object of the latest reported location of the tropical cyclone.
position.loc.long (number) The longitude of the latest reported location of the tropical cyclone.
position.loc.lat (number) The latitude of the latest reported location of the tropical 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 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
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 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) ISO 8601 date of the date/time of the forecast point information.
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 is forecast to be 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
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