Fetch all available data for a model's tropical cyclone for its latest or a requested initialization time. Use an operational ATCF ID or a generated ID returned by the index. See About the Tropical Cyclone Tracker for details about paths, landfalls, cones, and storm identification.
This endpoint is currently available for wm-6.
| Name | Type | Description |
|---|---|---|
| tc_id Required | string | Tropical cyclone ID to request. Accepts an ATCF or generated ID. |
| Name | Type | Description |
|---|---|---|
| initialization_time Optional | string (ISO 8601, YYYYMMDDHH, or latest) | Published initialization time to return. Default: latest run that contains this cyclone |
| include_members Optional | boolean | Include ensemble-member paths. Default: false |
| include_cones Optional | boolean | Include the ensemble-weighted cone when available. Default: false |
| format Optional | string | Response representation. Allowed: json, geojson, deck; Default: json |
| Name | Type | Description |
|---|---|---|
| tropical_cyclone_id Required | string | Tropical cyclone ID to request. Accepts an ATCF or generated ID. Supplied as the positional argument after detail. |
| -m , --model Optional | string | Weather model to use. Allowed: wm-6; Default: wm-6 |
| --initialization-time Optional | string (ISO 8601, YYYYMMDDHH, or latest) | Published initialization time to return. Default: latest run that contains this cyclone |
| --include-members Optional | flag | Include ensemble-member paths. Default: false |
| --include-cones Optional | flag | Include the ensemble-weighted cone when available. Default: false |
| -f , --format Optional | string | Response representation. Allowed: json, geojson, deck; Default: json |
| Name | Type | Description |
|---|---|---|
| tropical_cyclone_id Required | str | Tropical cyclone ID to request. Accepts an ATCF or generated ID. |
| model Optional | str | Weather model to use. Allowed: wm-6; Default: wm-6 |
| initialization_time Optional | str (ISO 8601, YYYYMMDDHH, or latest) | Published initialization time to return. Default: latest run that contains this cyclone |
| include_members Optional | bool | Include ensemble-member paths. Default: false |
| include_cones Optional | bool | Include the ensemble-weighted cone when available. Default: false |
| format Optional | str | Response representation. Allowed: json, geojson, deck; Default: json |
| output_file Optional | str | Path to save the response data. |
| print_response Optional | bool | If true, prints the response data. Default: false |
| Format | Description |
|---|---|
| json | Detailed tropical cyclone JSON. |
| geojson | GeoJSON FeatureCollection with mean-path lines and selectable forecast-point features, landfalls, plus requested member-path lines, member forecast points, and cones. All coordinates are rounded to 0.0001°. Download an example GeoJSON response. |
| deck | ATCF A-deck attachment. Matched storms include a WMSH ensemble mean and all matched members; unmatched tracks include their single member. Download an example A-deck response. |
| Name | Type | Description |
|---|---|---|
| tropical_cyclone_id | string | Operational ATCF ID, or the generated ID for an unmatched track. |
| storm_name | string | null | Operational storm name, when available. |
| basins | string[] | Basins occupied by the cyclone, in first-seen order. |
| genesis | object | null | Earliest published tropical or subtropical position. |
| latitude | number | Genesis latitude, rounded to 0.0001°. Unit: degrees |
| longitude | number | Genesis longitude, rounded to 0.0001°. Unit: degrees |
| initialization_time | string (ISO 8601) | The forecast initialization time. |
| forecast_zero | string (ISO 8601) | Valid time of forecast hour 0. |
| start_time | string (ISO 8601) | Earliest track time for the selected initialization time. |
| end_time | string (ISO 8601) | Latest track time for the selected initialization time. |
| landfalls | object[] | Water-to-land crossings from individual member paths. Crossings within 20 miles on the same connected landmass are consolidated. Landfall locations use NOAA GSHHG 2.3.7's high-resolution shoreline polygons. |
| valid_at | string (ISO 8601) | Interpolated crossing time. |
| latitude | number | Crossing latitude, rounded to 0.0001°. Unit: degrees |
| longitude | number | Crossing longitude, rounded to 0.0001°. Unit: degrees |
| max_wind_kt | number | null | Interpolated member wind, rounded to 0.1 kt. Unit: kt |
| min_mslp_hpa | number | null | Interpolated member pressure, rounded to 0.1 hPa. Unit: hPa |
| storm_type | string | null | Cyclone classification at landfall. |
| ensemble_member | integer | Member that produced the crossing. |
| max_wind_kt | number | null | Maximum wind, rounded to 0.1 kt. Unit: kt |
| min_mslp_hpa | number | null | Minimum mean sea-level pressure, rounded to 0.1 hPa. Unit: hPa |
| mean_path | object[] | Ensemble-mean path for a matched storm; empty for an unmatched track. |
| valid_at | string (ISO 8601) | Point valid time. |
| forecast_hour | integer | Forecast hour from forecast_zero. Unit: hours |
| latitude | number | Mean latitude, rounded to 0.0001°. Unit: degrees |
| longitude | number | Mean longitude, rounded to 0.0001°. Unit: degrees |
| max_wind_kt | number | null | Mean wind, rounded to 0.1 kt. Unit: kt |
| min_mslp_hpa | number | null | Mean cyclone-center pressure, rounded to 0.1 hPa. Unit: hPa |
| storm_type | string | null | Mean cyclone classification. |
| contributing_members_count | integer | Members contributing to this mean point. |
| matched_members | integer | Member tracks represented by this cyclone. |
| ens_size | integer | Full ensemble size. |
| members_path | object[] | Member paths. Present when: include_members=true |
| member | integer | Ensemble member number. |
| path | object[] | Path points with the same fields as mean_path, except contributor count. |
| cones | object[] | Ensemble-weighted cone. Present when: include_cones=true and a cone is available |
| members_total | integer | Full ensemble size used as the cone-density denominator. |
| max_forecast_hour | integer | Last forecast hour represented by the cone. Unit: hours |
| geometry | object (GeoJSON Polygon or MultiPolygon) | Cone shape, with coordinates rounded to 0.0001°. |