Copy page

Tropical

Guide

The Tropical API provides location-based information about tropical cyclones, including past, current, and forecasted positions.

For full request and response field details, see Tropical Parameters.

Endpoint	Description
All active storms	Currently active government-issued storms
Search by year	Storms for a specific year
Search by year and basin	Storms for a year and basin
Search by year, basin, and ID	A specific storm
Forecasts	Storm forecast positions
Positions	Historical storm positions
Current position	Current storm position
Legacy endpoints (deprecated)	Deprecated cyclone endpoints

All government-issued active storms

Code
https://{baseUrl}/tropical/{version}/gov/storms/active?apikey={your key}

Example

Code
https://api.accuweather.com/tropical/v1/gov/storms/active?apikey={your key}

Code
[
  {
    "year": 2020,
    "basinId": "AL",
    "depressionNumber": 13,
    "name": "Laura",
    "isActive": true,
    "isSubtropical": false,
    "accuId": 13,
    "atcfId": 13,
    "govId": 13,
    "eventKey": "AL132020",
    "govBaseLink": "api.accuweather.com/tropical/v1/gov/storms/2020/AL/13",
    "accuBaseLink": "api.accuweather.com/tropical/v1/accu/storms/2020/AL/13",
    "atcfBaseLink": "api.accuweather.com/tropical/v1/atcf/storms/2020/AL/13"
  },
  ...
]

Search government-issued storms by year

Code
https://{baseUrl}/tropical/{version}/gov/storms/{yyyy}?apikey={your key}&details={true or false}&language={language code}

Example

Code
https://api.accuweather.com/tropical/v1/gov/storms/2009?apikey={your key}&details=true

Code
[
   {
       "year": 2009,
       "basinId": "AL",
       "depressionNumber": 1,
       "name": "TD 1",
       "isActive": false,
       "isRetired": false,
       "isSubtropical": false,
       "accuId": 1,
       "atcfId": 1,
       "govId": 1,
       "eventKey": "AL012009",
       "duration": {
           "startDateTime": "2009-05-28T15:00:00+00:00",
           "startEpochDateTime": 1243522800,
           "endDateTime": "2009-05-29T21:00:00+00:00",
           "endEpochDateTime": 1243630800
       },
       "peakIntensity": {
           "validDateTime": "2009-05-28T15:00:00+00:00",
           "validEpochDateTime": 1243522800,
           "status": "Tropical Depression",
           "localizedStatus": "Tropical Depression",
           "position": {
               "latitude": 37.3,
               "longitude": -71.0
           },
           "sustainedWind": {
               "metric": { "value": 55.6, "unit": "km/h", "unitType": 7 },
               "imperial": { "value": 35, "unit": "mi/h", "unitType": 9 }
           }
       },
       "govBaseLink": "api.accuweather.com/tropical/v1/gov/storms/2009/AL/1",
       "accuBaseLink": "api.accuweather.com/tropical/v1/accu/storms/2009/AL/1",
       "atcfBaseLink": "api.accuweather.com/tropical/v1/atcf/storms/2009/AL/1"
   },
   ...
]

Search government-issued storms by year and basin ID

Code
https://{baseUrl}/tropical/{version}/gov/storms/{yyyy}/{basinID}?apikey={your key}&details={true or false}&language={language code}

Example

Code
https://api.accuweather.com/tropical/v1/gov/storms/2018/NP?apikey={your key}&details=true&language=it

Code
[
  {
    "year": 2018,
    "basinId": "NP",
    "depressionNumber": 1,
    "name": "BOLAVEN",
    "isActive": false,
    "isRetired": false,
    "isSubtropical": false,
    "govId": 1,
    "eventKey": "NP012018",
    "duration": {
      "startDateTime": "2018-01-01T18:00:00+00:00",
      "startEpochDateTime": 1514829600,
      "endDateTime": "2018-01-04T00:00:00+00:00",
      "endEpochDateTime": 1515024000
    },
    "peakIntensity": {
      "validDateTime": "2018-01-01T18:00:00+00:00",
      "validEpochDateTime": 1514829600,
      "status": "Tropical Depression",
      "localizedStatus": "Depressione tropicale",
      "position": { "latitude": 9.4, "longitude": 124.6 },
      "sustainedWind": {
        "metric": { "value": 55.6, "unit": "km/h", "unitType": 7 },
        "imperial": { "value": 35, "unit": "mi/h", "unitType": 9 }
      }
    },
    "govBaseLink": "api.accuweather.com/tropical/v1/gov/storms/2018/NP/1"
  },
  {
    "year": 2018,
    "basinId": "NP",
    "depressionNumber": 2,
    "name": "SANBA",
    "isActive": false,
    "isRetired": false,
    "isSubtropical": false,
    "govId": 2,
    "eventKey": "NP022018",
    "duration": {
      "startDateTime": "2018-02-08T18:00:00+00:00",
      "startEpochDateTime": 1518112800,
      "endDateTime": "2018-02-15T06:00:00+00:00",
      "endEpochDateTime": 1518674400
    },
    "peakIntensity": {
      "validDateTime": "2018-02-10T18:00:00+00:00",
      "validEpochDateTime": 1518285600,
      "status": "Tropical Storm",
      "localizedStatus": "Temporale tropicale",
      "position": { "latitude": 6.6, "longitude": 137.2 },
      "sustainedWind": {
        "metric": { "value": 83.3, "unit": "km/h", "unitType": 7 },
        "imperial": { "value": 52, "unit": "mi/h", "unitType": 9 }
      }
    },
    "govBaseLink": "api.accuweather.com/tropical/v1/gov/storms/2018/NP/2"
  }
  // ...additional storms omitted
]

Search government-issued storms by year, basin ID, and government ID

Code
https://{baseUrl}/tropical/{version}/gov/storms/{yyyy}/{basinID}/{government ID}?apikey={your key}&details={true or false}&language={language code}

Example

Code
https://api.accuweather.com/tropical/v1/gov/storms/2018/NP/26?apikey={your key}

Code
{
  "year": 2018,
  "basinId": "NP",
  "depressionNumber": 26,
  "name": "MANGKHUT",
  "isActive": false,
  "isRetired": true,
  "isSubtropical": false,
  "govId": 26,
  "eventKey": "NP262018",
  "govBaseLink": "api.accuweather.com/tropical/v1/gov/storms/2018/NP/26"
}

Government-issued forecasts

Code
https://{baseUrl}/tropical/{version}/gov/storms/{yyyy}/{basinID}/{governmentID}/forecasts?apikey={your key}&details={true or false}&radiigeometry={true or false}&windowgeometry={true or false}&language={language code}

Example

Code
https://api.accuweather.com/tropical/v1/gov/storms/2018/NP/26/forecasts?apikey={your key}&details=true&radiigeometry=true&windowgeometry=true&language=it

Code
[
   {
       "validDateTime": "2018-09-16T18:00:00+00:00",
       "validEpochDateTime": 1537120800,
       "initializedDateTime": "2018-09-16T06:00:00+00:00",
       "epochInitializedDateTime": 1537077600,
       "position": {
           "latitude": 22.7,
           "longitude": 110.2
       },
       "maxWindGust": {
           "metric": { "Value": 138.9, "Unit": "km/h", "UnitType": 7 },
           "imperial": { "Value": 86, "Unit": "mi/h", "UnitType": 9 }
       },
       "sustainedWind": {
           "metric": { "Value": 111.1, "Unit": "km/h", "UnitType": 7 },
           "imperial": { "Value": 69, "Unit": "mi/h", "UnitType": 9 }
       },
       "status": "Severe Tropical Storm",
       "localizedStatus": "Tempesta tropicale forte",
       "window": { ... },
       "windRadiiSummary": [ ... ]
   },
   ...
]

Positions for an individual government-issued storm

Code
https://{baseUrl}/tropical/{version}/gov/storms/{yyyy}/{basinID}/{governmentID}/positions?apikey={your key}&details={true or false}&radiigeometry={true or false}&includelandmarks={true or false}&language={language code}

Example

Code
https://api.accuweather.com/tropical/v1/gov/storms/2018/NP/26/positions?apikey={your key}&details=true&radiigeometry=true&includelandmarks=true&language=de

Code
[
   {
       "validDateTime": "2018-09-16T06:00:00+00:00",
       "validEpochDateTime": 1537077600,
       "position": {
           "latitude": 21.6,
           "longitude": 113.6
       },
       "maxWindGust": {
           "metric": { "Value": 185.2, "Unit": "km/h", "UnitType": 7 },
           "imperial": { "Value": 115, "Unit": "mi/h", "UnitType": 9 }
       },
       "sustainedWind": {
           "metric": { "Value": 148.2, "Unit": "km/h", "UnitType": 7 },
           "imperial": { "Value": 92, "Unit": "mi/h", "UnitType": 9 }
       },
       "minimumPressure": null,
       "movement": {
           "direction": { "degrees": 300.0, "localized": "WNW", "english": "WNW" },
           "speed": {
               "metric": { "Value": 31.5, "Unit": "km/h", "UnitType": 7 },
               "imperial": { "Value": 20, "Unit": "mi/h", "UnitType": 9 }
           }
       },
       "status": "Typhoon",
       "localizedStatus": "Taifun",
       "isSubtropical": null,
       "landmarkReferences": [
           {
               "landmark": "HONG KONG",
               "direction": { "degrees": 225, "english": "SW" },
               "range": {
                   "Metric": { "Value": 86.9, "Unit": "km", "UnitType": 6 },
                   "Imperial": { "Value": 54, "Unit": "mi", "UnitType": 2 }
               }
           }
       ],
       "windRadiiSummary": [ ... ]
   },
   ...
]

Current position for an individual government-issued storm

Code
https://{baseUrl}/tropical/{version}/gov/storms/{yyyy}/{basinID}/{governmentID}/positions/current?apikey={your key}&details={true or false}&radiigeometry={true or false}&includelandmarks={true or false}&language={language code}

Example

Code
https://api.accuweather.com/tropical/v1/gov/storms/2018/NP/26/positions/current?apikey={your key}&details=true&radiigeometry=true&includelandmarks=true

Code
{
  "validDateTime": "2018-09-16T06:00:00+00:00",
  "validEpochDateTime": 1537077600,
  "position": { "latitude": 21.6, "longitude": 113.6 },
  "maxWindGust": {
    "metric": { "Value": 185.2, "Unit": "km/h", "UnitType": 7 },
    "imperial": { "Value": 115, "Unit": "mi/h", "UnitType": 9 }
  },
  "sustainedWind": {
    "metric": { "Value": 148.2, "Unit": "km/h", "UnitType": 7 },
    "imperial": { "Value": 92, "Unit": "mi/h", "UnitType": 9 }
  },
  "minimumPressure": null,
  "movement": {
    "direction": { "degrees": 300, "localized": null, "english": "WNW" },
    "speed": {
      "metric": { "Value": 31.5, "Unit": "km/h", "UnitType": 7 },
      "imperial": { "Value": 20, "Unit": "mi/h", "UnitType": 9 }
    }
  },
  "status": "Typhoon",
  "isSubtropical": null,
  "landmarkReferences": [
    {
      "landmark": "HONG KONG",
      "direction": { "degrees": 225, "english": "SW" },
      "range": {
        "Metric": { "Value": 86.9, "Unit": "km", "UnitType": 6 },
        "Imperial": { "Value": 54, "Unit": "mi", "UnitType": 2 }
      }
    }
  ],
  "windRadiiSummary": [
    {
      "validDateTime": "2018-09-16T06:00:00+00:00",
      "validEpochDateTime": 1537077600,
      "windSpeed": {
        "metric": { "Value": 63, "Unit": "km/h", "UnitType": 7 },
        "imperial": { "Value": 39, "Unit": "mi/h", "UnitType": 9 }
      },
      "radiusSectorData": [
        { "beginBearing": 0,   "endBearing": 90,  "range": 275 },
        { "beginBearing": 90,  "endBearing": 180, "range": 200 },
        { "beginBearing": 180, "endBearing": 270, "range": 165 },
        { "beginBearing": 270, "endBearing": 360, "range": 215 }
      ],
      "radiiGeometry": {
        "type": "Polygon",
        "coordinates": [
          [
            [114.45386338352, 26.105900212542],
            [114.42750521024, 26.110573304426]
            // ...polygon vertices omitted
          ]
        ]
      }
    }
    // ...additional wind radii summaries omitted
  ]
}

Active tropical cyclones (deprecated)

Note: This endpoint is deprecated. Use the government-issued active storms endpoint instead.

Code
https://{baseUrl}/tropical/{version}/storms/active?apikey={your key}

Any tropical cyclone (deprecated)

Note: This endpoint is deprecated. Use the government-issued storm search endpoints instead.

Code
https://{baseUrl}/tropical/{version}/storms/{yyyy}/{basinID}/{depressionID}?apikey={your key}

Tropical cyclone current position (deprecated)

Note: This endpoint is deprecated.

Code
https://{baseUrl}/tropical/{version}/storms/{yyyy}/{basinID}/{depressionID}/positions/current?apikey={your key}

Tropical cyclone positions (deprecated)

Note: This endpoint is deprecated.

Code
https://{baseUrl}/tropical/{version}/storms/{yyyy}/{basinID}/{depressionID}/positions?apikey={your key}

Tropical cyclone forecasts (deprecated)

Note: This endpoint is deprecated.

Code
https://{baseUrl}/tropical/{version}/storms/{yyyy}/{basinID}/{depressionID}/forecasts?apikey={your key}