This endpoint lists tropical cyclones captured across all initialization times
for a model. Use min_time, max_time, or both to
find cyclones whose lifetime overlaps the specified window. Results are ordered
by start_time from newest to oldest. To find every initialization
time that captures a cyclone, use the
tropical cyclone initialization-times endpoint.
See About the Tropical Cyclone Tracker
for details about operational and generated storm IDs.
This endpoint is currently available for wm-6.
| Name | Type | Description |
|---|---|---|
| basin Optional | string | Return cyclones that occupied this basin at any published initialization time. Allowed: AL, EP, CP, WP, NI, SI, AU, SP |
| include_unofficial_ids Optional | boolean | Also include unmatched ensemble member tracks. Default: false |
| min_time Optional | string (ISO 8601 or YYYYMMDDHH) | Return cyclones whose published lifetime ends at or after this time. May be used independently or with max_time. |
| max_time Optional | string (ISO 8601 or YYYYMMDDHH) | Return cyclones whose published lifetime begins at or before this time. May be used independently or with min_time. |
| page Optional | integer | Zero-indexed page number. Default: 0 |
| page_size Optional | integer | Number of results per page. Max: 500; Default: 64 |
| Name | Type | Description |
|---|---|---|
| -m , --model Optional | string | Weather model to use. Allowed: wm-6; Default: wm-6 |
| -b , --basin Optional | string | Return cyclones that occupied this basin at any published initialization time. Allowed: AL, EP, CP, WP, NI, SI, AU, SP |
| --include-unofficial-ids Optional | flag | Also include unmatched ensemble member tracks. Default: false |
| --min-time Optional | string (ISO 8601 or YYYYMMDDHH) | Return cyclones whose published lifetime ends at or after this time. May be used independently or with max_time. |
| --max-time Optional | string (ISO 8601 or YYYYMMDDHH) | Return cyclones whose published lifetime begins at or before this time. May be used independently or with min_time. |
| --page Optional | integer | Zero-indexed page number. Default: 0 |
| --page-size Optional | integer | Number of results per page. Max: 500; Default: 64 |
| Name | Type | Description |
|---|---|---|
| model Optional | str | Weather model to use. Allowed: wm-6; Default: wm-6 |
| basin Optional | str | Return cyclones that occupied this basin at any published initialization time. Allowed: AL, EP, CP, WP, NI, SI, AU, SP |
| include_unofficial_ids Optional | bool | Also include unmatched ensemble member tracks. Default: false |
| min_time Optional | str (ISO 8601 or YYYYMMDDHH) | Return cyclones whose published lifetime ends at or after this time. May be used independently or with max_time. |
| max_time Optional | str (ISO 8601 or YYYYMMDDHH) | Return cyclones whose published lifetime begins at or before this time. May be used independently or with min_time. |
| page Optional | int | Zero-indexed page number. Default: 0 |
| page_size Optional | int | Number of results per page. Max: 500; Default: 64 |
| output_file Optional | str | Path to save the response data. |
| print_response Optional | bool | If true, prints the response data. Default: false |
| Name | Type | Description |
|---|---|---|
| tropical_cyclones | object | Keyed by tropical cyclone ID. |
| {tropical_cyclone_id} | object | Metadata for one cyclone. |
| tropical_cyclone_id | string | Operational ATCF ID, or a generated ID when unofficial IDs were requested. |
| storm_name | string | null | Operational storm name, when available. |
| basins | string[] | Basins occupied by the cyclone, in first-seen order. |
| start_time | string (ISO 8601) | Earliest track time across all initialization times. |
| end_time | string (ISO 8601) | Latest track time across all initialization times. |
| total | integer | Total number of matching cyclones. |
| page | integer | Current page number. |
| page_size | integer | Number of results per page. |