---
title: "Use to get a list of storms issued by national weather forecasting agencies."
method: GET
path: "/weather/tropical/storms/{format}"
---

# Use to get a list of storms issued by national weather forecasting agencies.

`GET /weather/tropical/storms/{format}`

The `Get Tropical Storm Search` API is an HTTP `GET` request that returns a
list of government-issued tropical storms by year, basin ID, and government ID.
Information about the tropical storms includes, government ID, basin ID,
status, year, name and if it is subtropical.

## Path parameters

- `format` 'json', required

## Query parameters

- `api-version` string, required
- `year` integer, required
- `basinId` 'AL' | 'CP' | 'EP' | 'NI' | 'NP' | 'SI' | 'SP'
- `govId` integer

## Headers

- `x-ms-client-id` string

## Response `200`

The request has succeeded.

- StormSearchResult — Contains a list of government-issued storms that meet the specified search criteria, including details such as the storm's basin ID, government-issued ID and status.
  - `results` StormSearchResultItem[] — Array of [StormSearchResultItem](#stormsearchresultitem) objects, each representing a tropical storm matching the search criteria provided in the request.
    - `year` string — Specifies the year in which the tropical storm originated.
    - `basinId` 'AL' | 'CP' | 'EP' | 'NI' | 'NP' | 'SI' | 'SP' — Basin identifier for tropical storms.
    - `name` string — Identifies the tropical storm by its official name, as designated by the relevant national weather forecasting agency.
    - `isActive` boolean — Indicates whether the tropical storm is currently active. If true, the storm is active; if false, the storm is not active
    - `isRetired` boolean — Returns true if the storm has been permanently retired in the source basin.
    - `isSubtropical` boolean — Returns true if the storm is classified as a subtropical cyclone, meaning it has both tropical and extratropical features.
    - `govId` integer — A unique identifier assigned to tropical storms by national weather forecasting agencies. This identifier helps track and reference specific storms accurately, including its status, location, and intensity. This will match the depression number.
  - `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.

---

[API](https://skmtc.net/azure/apis/maps-weather.md) · [All operations](https://skmtc.net/azure/apis/maps-weather/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/maps-weather/versions/3c076fdd2918/schema)