--- title: "Use to get a list of tropical storms forecasted by national weather forecasting agencies." method: GET path: "/weather/tropical/storms/forecasts/{format}" --- # Use to get a list of tropical storms forecasted by national weather forecasting agencies. `GET /weather/tropical/storms/forecasts/{format}` The `Get Tropical Storm Forecasts` API is an HTTP `GET` request that returns individual government-issued tropical storm forecasts. Information about the forecasted tropical storms includes, location, status, date the forecast was created, window, wind speed and wind radii. ## Path parameters - `format` 'json', required ## Query parameters - `api-version` string, required - `year` integer, required - `basinId` 'AL' | 'CP' | 'EP' | 'NI' | 'NP' | 'SI' | 'SP', required - `govId` integer, required - `unit` 'imperial' | 'metric' - `details` boolean - `radiiGeometry` boolean - `windowGeometry` boolean ## Headers - `x-ms-client-id` string ## Response `200` The request has succeeded. - StormForecastResult — An array of [StormForecast](#stormforecast) objects, each detailing individual storm forecasts issued by government authorities. - `results` StormForecast[] — An array of forecast data for tropical storms, including predicted paths, intensities, and other relevant details. These forecasts are issued by government authorities. - `dateTime` string — Date and time that the current forecast is valid, displayed in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format (yyyy-mm-ddThh:mm:ss-hh:mm). For example, *2025-04-29T07:00:00-07:00*. - `initializedDateTime` string — Date and time that the forecast was created, displayed in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format (yyyy-mm-ddThh:mm:ss-hh:mm). For example, *2025-04-29T07:00:00-07:00*. - `location` LatLongPair — A location represented as a latitude and longitude. - `latitude` number, double — Latitude property - `longitude` number, double — Longitude property - `maxWindGust` WeatherValue — Specific value of a given unit related to weather. - `value` number, float — Rounded value. - `unit` string — Type of unit for the returned value. - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types). - `sustainedWind` WeatherValue — Specific value of a given unit related to weather. - `value` number, float — Rounded value. - `unit` string — Type of unit for the returned value. - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types). - `status` string — Indicates the current state or condition of the storm. This property provides information on whether the storm is active, dissipating, or has reached another significant status. Possible values: - `window` WeatherWindow — Forecast window for the storm - `left` LatLongPair — A location represented as a latitude and longitude. - `latitude` number, double — Latitude property - `longitude` number, double — Longitude property - `right` LatLongPair — A location represented as a latitude and longitude. - `latitude` number, double — Latitude property - `longitude` number, double — Longitude property - `beginDateTime` string, date-time — DateTime of the beginning of the window of movement, displayed in ISO8601 format. - `endDateTime` string, date-time — DateTime of the end of the window of movement, displayed in ISO8601 format. - `beginStatus` string — Storm status at the beginning of the window. - `endStatus` string — Storm status at the end of the window. - `geometry` GeoJsonGeometry — A valid `GeoJSON` geometry object. The type must be one of the seven valid GeoJSON geometry types - Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon and GeometryCollection. Please refer to [RFC 7946](https://tools.ietf.org/html/rfc7946#section-3.1) for details. - `type` 'Point' | 'MultiPoint' | 'LineString' | 'MultiLineString' | 'Polygon' | 'MultiPolygon' | 'GeometryCollection' | 'Feature' | 'FeatureCollection', required — Specifies the `GeoJSON` type. Must be one of the nine valid GeoJSON object types - Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature and FeatureCollection. - `windRadiiSummary` StormWindRadiiSummary[] — Contains an array of [StormWindRadiiSummary](#stormwindradiisummary) objects, detailing wind radii in different quadrants around the storm's center. Displayed when `details=true` or `radiiGeometry=true` in the request. - `dateTime` string — Date and time that the wind radii summary data is valid, displayed in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format (yyyy-mm-ddThh:mm:ss-hh:mm). For example, *2025-04-29T07:00:00-07:00*. - `windSpeed` WeatherValue — Specific value of a given unit related to weather. - `value` number, float — Rounded value. - `unit` string — Type of unit for the returned value. - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types). - `radiusSectorData` RadiusSector[] — An array of [RadiusSector](#RadiusSector) objects. Each object contains detailed geographical information (in geoJSON format) needed to plot wind radius quadrants: 0-90° for NE, 90-180° for SE, 180-270° for SW, and 270-360° for NW. - `beginBearing` number, double — Bearing, in degrees, of the beginning of the quadrant. - `endBearing` number, double — Bearing, in degrees, of the end of the quadrant. - `range` number, double — The radius of the quadrant, in nautical miles. - `radiiGeometry` GeoJsonGeometry — A valid `GeoJSON` geometry object. The type must be one of the seven valid GeoJSON geometry types - Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon and GeometryCollection. Please refer to [RFC 7946](https://tools.ietf.org/html/rfc7946#section-3.1) for details. - `type` 'Point' | 'MultiPoint' | 'LineString' | 'MultiLineString' | 'Polygon' | 'MultiPolygon' | 'GeometryCollection' | 'Feature' | 'FeatureCollection', required — Specifies the `GeoJSON` type. Must be one of the nine valid GeoJSON object types - Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature and FeatureCollection. - `nextLink` string — Contains the URL to fetch the next page of results if the response is paginated. This is useful when the response is too large to be returned in a single call, allowing users to navigate through multiple pages of results. ## Other responses - `default` — An unexpected error response. ## Changes - **2026-07-13** (1.0) `3c076fdd2918` — 1 info - endpoint added - **2021-07-20** (1.0) `5ddaf6c2b291` — 1 breaking - api path removed without deprecation [Change history](https://skmtc.dev/azure/apis/maps-weather/changes/weather/tropical/storms/forecasts/:format/get.md) --- [API](https://skmtc.dev/azure/apis/maps-weather.md) · [All operations](https://skmtc.dev/azure/apis/maps-weather/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/maps-weather/revisions/3c076fdd2918/schema)