# 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](/developers/tropical/parameters).

:::note{title="Base URLs"}

- **Production:** api.accuweather.com
- **Development:** apidev.accuweather.com

Examples below use the production host. Swap in apidev.accuweather.com for development.

:::

| Endpoint | Description |
|---|---|
| [All active storms](#all-government-issued-active-storms) | Currently active government-issued storms |
| [Search by year](#search-government-issued-storms-by-year) | Storms for a specific year |
| [Search by year and basin](#search-government-issued-storms-by-year-and-basin-id) | Storms for a year and basin |
| [Search by year, basin, and ID](#search-government-issued-storms-by-year-basin-id-and-government-id) | A specific storm |
| [Forecasts](#government-issued-forecasts) | Storm forecast positions |
| [Positions](#positions-for-an-individual-government-issued-storm) | Historical storm positions |
| [Current position](#current-position-for-an-individual-government-issued-storm) | Current storm position |
| [Legacy endpoints (deprecated)](#active-tropical-cyclones-deprecated) | Deprecated cyclone endpoints |

## All government-issued active storms

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

### Example

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

```json
[
  {
    "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

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

### Example

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

```json
[
   {
       "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

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

### Example

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

```json
[
  {
    "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

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

### Example

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

```json
{
  "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

```
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

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

```json
[
   {
       "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

```
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

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

```json
[
   {
       "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

```
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

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

```json
{
  "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.

```
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.

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

## Tropical cyclone current position (deprecated)

> **Note:** This endpoint is deprecated.

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

## Tropical cyclone positions (deprecated)

> **Note:** This endpoint is deprecated.

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

## Tropical cyclone forecasts (deprecated)

> **Note:** This endpoint is deprecated.

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