GET Tropical Cyclones

This endpoint allows getting the predicted ground track of active tropical cyclones. It returns a dictionary keyed by tropical cyclone ID, where each value is an array of forecast ground track points.

Use the default URL for the latest available model, or use the model-specific URL below to choose a weather model. You can find a list of available models here.

forecasts/v1/tropical_cyclonesforecasts/v1/tropical_cyclones

/forecasts/v1/ecmwf-det/tropical_cyclones/forecasts/v1/ecmwf-det/tropical_cyclones

/forecasts/v1/ecmwf-ens/tropical_cyclones/forecasts/v1/ecmwf-ens/tropical_cyclones

/forecasts/v1/aifs/tropical_cyclones/forecasts/v1/aifs/tropical_cyclones

/forecasts/v1/gfs/tropical_cyclones/forecasts/v1/gfs/tropical_cyclones

/forecasts/v1/hrrr/tropical_cyclones/forecasts/v1/hrrr/tropical_cyclones

windborne tropical_cycloneswindborne tropical_cyclones

from windborne import get_tropical_cyclonesfrom windborne import get_tropical_cyclones

Available Basins

Name	Description
NA	North Atlantic Basin spanning from African Coast (20°E) to 140°W and Equator to 90°N.
EP	Eastern Pacific Basin spanning from 140°W to 180°W and Equator to 90°N.
WP	Western Pacific Basin spanning from 100°E to 180°E and Equator to 60°N.
NI	North Indian Ocean Basin spanning from 45°E to 100°E and Equator to 90°N.
SI	South-West Indian Ocean Basin spanning from 20°E to 90°E and 40°S to Equator.
AU	Australian Region Basin spanning from 90°E to 160°E and 36°S to Equator.
SP	South Pacific Basin spanning from 160°E to 120°W and 40°S to Equator.

Query parameters

Name	Description	Format
initialization_time Optional	An ISO 8601 date string representing the time at which the forecast was made. Uses only date, hour and minutes. Seconds are discarded. If omitted, the latest forecast is used.	YYYY-MM-DDThh:mm:ssZ
basin Optional	Ocean basin filter. If omitted, includes all basins.	NA, EP, WP, NI, SI, AU, SP

Name	Description	Format
initialization_time Optional	An ISO 8601 date string representing the time at which the forecast was made. Uses only date, hour and minutes. Seconds are discarded. If omitted, the latest forecast is used.	YYYY-MM-DDThh:mm:ssZ
basin Optional	Ocean basin filter. If omitted, includes all basins.	NA, EP, WP, NI, SI, AU, SP

Name	Description	Format
initialization_time Optional	An ISO 8601 date string representing the time at which the forecast was made. Uses only date, hour and minutes. Seconds are discarded. If omitted, the latest forecast is used.	YYYY-MM-DDThh:mm:ssZ
basin Optional	Ocean basin filter. If omitted, includes all basins.	NA, EP, WP, NI, SI, AU, SP

Name	Description	Format
initialization_time Optional	An ISO 8601 date string representing the time at which the forecast was made. Uses only date, hour and minutes. Seconds are discarded. If omitted, the latest forecast is used.	YYYY-MM-DDThh:mm:ssZ
basin Optional	Ocean basin filter. If omitted, includes all basins.	NA, EP, WP, NI, SI, AU, SP

Name	Description	Format
initialization_time Optional	An ISO 8601 date string representing the time at which the forecast was made. Uses only date, hour and minutes. Seconds are discarded. If omitted, the latest forecast is used.	YYYY-MM-DDThh:mm:ssZ
basin Optional	Ocean basin filter. If omitted, includes all basins.	NA, EP, WP, NI, SI, AU, SP

Name	Description
-m --model	Set to ecmwf-det .
initialization_time Optional	An ISO 8601 date string representing the time at which the forecast was made. Supports YYYY-MM-DDThh:mm:ssZ. Uses only date, hour and minutes. Seconds are discarded. If omitted, the latest forecast is used.
-b --basin Optional	Ocean basin filter. NA, EP, WP, NI, SI, AU, SP.
output_file Optional	Save response to file. Supports .json, .csv, .gpx, .geojson, .kml, .little_r.

Name	Description
-m --model	Set to ecmwf-ens .
initialization_time Optional	An ISO 8601 date string representing the time at which the forecast was made. Supports YYYY-MM-DDThh:mm:ssZ. Uses only date, hour and minutes. Seconds are discarded. If omitted, the latest forecast is used.
-b --basin Optional	Ocean basin filter. NA, EP, WP, NI, SI, AU, SP.
output_file Optional	Save response to file. Supports .json, .csv, .gpx, .geojson, .kml, .little_r.

Name	Description
-m --model	Set to aifs .
initialization_time Optional	An ISO 8601 date string representing the time at which the forecast was made. Supports YYYY-MM-DDThh:mm:ssZ. Uses only date, hour and minutes. Seconds are discarded. If omitted, the latest forecast is used.
-b --basin Optional	Ocean basin filter. NA, EP, WP, NI, SI, AU, SP.
output_file Optional	Save response to file. Supports .json, .csv, .gpx, .geojson, .kml, .little_r.

Name	Description
-m --model	Set to gfs .
initialization_time Optional	An ISO 8601 date string representing the time at which the forecast was made. Supports YYYY-MM-DDThh:mm:ssZ. Uses only date, hour and minutes. Seconds are discarded. If omitted, the latest forecast is used.
-b --basin Optional	Ocean basin filter. NA, EP, WP, NI, SI, AU, SP.
output_file Optional	Save response to file. Supports .json, .csv, .gpx, .geojson, .kml, .little_r.

Name	Description
-m --model	Set to hrrr .
initialization_time Optional	An ISO 8601 date string representing the time at which the forecast was made. Supports YYYY-MM-DDThh:mm:ssZ. Uses only date, hour and minutes. Seconds are discarded. If omitted, the latest forecast is used.
-b --basin Optional	Ocean basin filter. NA, EP, WP, NI, SI, AU, SP.
output_file Optional	Save response to file. Supports .json, .csv, .gpx, .geojson, .kml, .little_r.

Name	Description
model	Set to ecmwf-det .
initialization_time Optional	An ISO 8601 date string representing the time at which the forecast was made. Supports YYYY-MM-DDThh:mm:ssZ. Uses only date, hour and minutes. Seconds are discarded. If omitted, the latest forecast is used.
basin Optional	Ocean basin filter. NA, EP, WP, NI, SI, AU, SP.
output_file Optional	Save response to file. Supports .json, .csv, .gpx, .geojson, .kml, .little_r.

Name	Description
model	Set to ecmwf-ens .
initialization_time Optional	An ISO 8601 date string representing the time at which the forecast was made. Supports YYYY-MM-DDThh:mm:ssZ. Uses only date, hour and minutes. Seconds are discarded. If omitted, the latest forecast is used.
basin Optional	Ocean basin filter. NA, EP, WP, NI, SI, AU, SP.
output_file Optional	Save response to file. Supports .json, .csv, .gpx, .geojson, .kml, .little_r.

Name	Description
model	Set to aifs .
initialization_time Optional	An ISO 8601 date string representing the time at which the forecast was made. Supports YYYY-MM-DDThh:mm:ssZ. Uses only date, hour and minutes. Seconds are discarded. If omitted, the latest forecast is used.
basin Optional	Ocean basin filter. NA, EP, WP, NI, SI, AU, SP.
output_file Optional	Save response to file. Supports .json, .csv, .gpx, .geojson, .kml, .little_r.

Name	Description
model	Set to gfs .
initialization_time Optional	An ISO 8601 date string representing the time at which the forecast was made. Supports YYYY-MM-DDThh:mm:ssZ. Uses only date, hour and minutes. Seconds are discarded. If omitted, the latest forecast is used.
basin Optional	Ocean basin filter. NA, EP, WP, NI, SI, AU, SP.
output_file Optional	Save response to file. Supports .json, .csv, .gpx, .geojson, .kml, .little_r.

Name	Description
model	Set to hrrr .
initialization_time Optional	An ISO 8601 date string representing the time at which the forecast was made. Supports YYYY-MM-DDThh:mm:ssZ. Uses only date, hour and minutes. Seconds are discarded. If omitted, the latest forecast is used.
basin Optional	Ocean basin filter. NA, EP, WP, NI, SI, AU, SP.
output_file Optional	Save response to file. Supports .json, .csv, .gpx, .geojson, .kml, .little_r.

Response parameters

Returns an object (dictionary) whose keys are cyclone IDs and values are arrays of ground track points.

Field	Description	Type
cyclone_id	Dictionary key representing a unique tropical cyclone ID.	string (key)
track_points	Array of predicted ground track points.	array
latitude	Latitude of forecast point.	number
longitude	Longitude of forecast point.	number
time	ISO 8601 timestamp when the point is valid.	string

Examples

curl -H "Authorization: Bearer $WB_API_KEY" "https://api.windbornesystems.com/forecasts/v1/ecmwf-det/tropical_cyclones"curl -H "Authorization: Bearer $WB_API_KEY" "https://api.windbornesystems.com/forecasts/v1/ecmwf-det/tropical_cyclones"

# Display cyclones for latest initialization time# Display cyclones for latest initialization time

windborne tropical_cyclones -m ecmwf-detwindborne tropical_cyclones -m ecmwf-det

# Display cyclones for given initialization time# Display cyclones for given initialization time

windborne tropical_cyclones {{LATEST_INITIALIZATION_TIME:ecmwf-det}} -m ecmwf-detwindborne tropical_cyclones {{LATEST_INITIALIZATION_TIME:ecmwf-det}} -m ecmwf-det

# Display cyclones for given initialization time within basin# Display cyclones for given initialization time within basin

windborne tropical_cyclones -b NA {{LATEST_INITIALIZATION_TIME:ecmwf-det}} -m ecmwf-detwindborne tropical_cyclones -b NA {{LATEST_INITIALIZATION_TIME:ecmwf-det}} -m ecmwf-det

# Save cyclones in file# Save cyclones in file

windborne tropical_cyclones {{LATEST_INITIALIZATION_TIME:ecmwf-det}} my_cyclone_data.json -m ecmwf-detwindborne tropical_cyclones {{LATEST_INITIALIZATION_TIME:ecmwf-det}} my_cyclone_data.json -m ecmwf-det

windborne tropical_cyclones -b NA {{LATEST_INITIALIZATION_TIME:ecmwf-det}} my_cyclone_data.csv -m ecmwf-detwindborne tropical_cyclones -b NA {{LATEST_INITIALIZATION_TIME:ecmwf-det}} my_cyclone_data.csv -m ecmwf-det

windborne tropical_cyclones {{LATEST_INITIALIZATION_TIME:ecmwf-det}} my_cyclone_data.kml -m ecmwf-detwindborne tropical_cyclones {{LATEST_INITIALIZATION_TIME:ecmwf-det}} my_cyclone_data.kml -m ecmwf-det

windborne tropical_cyclones {{LATEST_INITIALIZATION_TIME:ecmwf-det}} my_cyclone_data.geojson -m ecmwf-detwindborne tropical_cyclones {{LATEST_INITIALIZATION_TIME:ecmwf-det}} my_cyclone_data.geojson -m ecmwf-det

windborne tropical_cyclones {{LATEST_INITIALIZATION_TIME:ecmwf-det}} my_cyclone_data.little_r -m ecmwf-detwindborne tropical_cyclones {{LATEST_INITIALIZATION_TIME:ecmwf-det}} my_cyclone_data.little_r -m ecmwf-det

windborne tropical_cyclones {{LATEST_INITIALIZATION_TIME:ecmwf-det}} my_cyclone_data.gpx -m ecmwf-detwindborne tropical_cyclones {{LATEST_INITIALIZATION_TIME:ecmwf-det}} my_cyclone_data.gpx -m ecmwf-det

content-type: application/json

1 {{

2 "2025070312-B": [ "2025070312-B": [

3 { {

4 "latitude": 31.75, "latitude": 31.75,

5 "longitude": 62.5, "longitude": 62.5,

6 "time": "2025-07-05T06:00:00Z" "time": "2025-07-05T06:00:00Z"

7 }, },

8 { {

9 "latitude": 31.5, "latitude": 31.5,

10 "longitude": 62.75, "longitude": 62.75,

11 "time": "2025-07-05T12:00:00Z" "time": "2025-07-05T12:00:00Z"

12 }, },

13 { {

14 "latitude": 32, "latitude": 32,

15 "longitude": 63, "longitude": 63,

16 "time": "2025-07-05T18:00:00Z" "time": "2025-07-05T18:00:00Z"

17 }, },

18 { {

19 "latitude": 32, "latitude": 32,

20 "longitude": 63, "longitude": 63,

21 "time": "2025-07-06T00:00:00Z" "time": "2025-07-06T00:00:00Z"

22 }, },

23 { {

24 "latitude": 32, "latitude": 32,

25 "longitude": 62.75, "longitude": 62.75,

26 "time": "2025-07-06T06:00:00Z" "time": "2025-07-06T06:00:00Z"

27 }, },

28 { {

29 "latitude": 32, "latitude": 32,

30 "longitude": 62.75, "longitude": 62.75,

31 "time": "2025-07-06T18:00:00Z" "time": "2025-07-06T18:00:00Z"

32 }, },

33 { {

34 "latitude": 32, "latitude": 32,

35 "longitude": 63, "longitude": 63,

36 "time": "2025-07-07T00:00:00Z" "time": "2025-07-07T00:00:00Z"

37 }, },

38 { {

39 "latitude": 31.75, "latitude": 31.75,

40 "longitude": 62.5, "longitude": 62.5,

41 "time": "2025-07-07T06:00:00Z" "time": "2025-07-07T06:00:00Z"

42 }, },

43 { {

44 "latitude": 32, "latitude": 32,

45 "longitude": 62.25, "longitude": 62.25,

46 "time": "2025-07-07T12:00:00Z" "time": "2025-07-07T12:00:00Z"

47 }, },

48 { {

49 "latitude": 32, "latitude": 32,

50 "longitude": 63, "longitude": 63,

51 "time": "2025-07-07T18:00:00Z" "time": "2025-07-07T18:00:00Z"

52 }, },

53 { {

54 "latitude": 31.75, "latitude": 31.75,

55 "longitude": 62.75, "longitude": 62.75,

56 "time": "2025-07-08T00:00:00Z" "time": "2025-07-08T00:00:00Z"

57 }, },

58 { {

59 "latitude": 31.5, "latitude": 31.5,

60 "longitude": 62.25, "longitude": 62.25,

61 "time": "2025-07-08T12:00:00Z" "time": "2025-07-08T12:00:00Z"

62 }, },

63 { {

64 "latitude": 31.75, "latitude": 31.75,

65 "longitude": 63, "longitude": 63,

66 "time": "2025-07-08T18:00:00Z" "time": "2025-07-08T18:00:00Z"

67 } }

68 ], ],

69 "98W-2025070312-A": [ "98W-2025070312-A": [

70 { {

71 "latitude": 24.75, "latitude": 24.75,

72 "longitude": 120.5, "longitude": 120.5,

73 "time": "2025-07-03T12:00:00Z" "time": "2025-07-03T12:00:00Z"

74 }, },

75 { {

76 "latitude": 19.75, "latitude": 19.75,

77 "longitude": 119.25, "longitude": 119.25,

78 "time": "2025-07-03T18:00:00Z" "time": "2025-07-03T18:00:00Z"

79 }, },

80 { {

81 "latitude": 20, "latitude": 20,

82 "longitude": 118.5, "longitude": 118.5,

83 "time": "2025-07-04T00:00:00Z" "time": "2025-07-04T00:00:00Z"

84 }, },

85 { {

86 "latitude": 20.25, "latitude": 20.25,

87 "longitude": 118, "longitude": 118,

88 "time": "2025-07-04T06:00:00Z" "time": "2025-07-04T06:00:00Z"

89 }, },

90 { {

91 "latitude": 20.25, "latitude": 20.25,

92 "longitude": 117.5, "longitude": 117.5,

93 "time": "2025-07-04T12:00:00Z" "time": "2025-07-04T12:00:00Z"

94 }, },

95 { {

96 "latitude": 20.5, "latitude": 20.5,

97 "longitude": 117.25, "longitude": 117.25,

98 "time": "2025-07-04T18:00:00Z" "time": "2025-07-04T18:00:00Z"

99 }, },

100 { {

101 "latitude": 20.5, "latitude": 20.5,

102 "longitude": 117, "longitude": 117,

103 "time": "2025-07-05T00:00:00Z" "time": "2025-07-05T00:00:00Z"

104 }, },

105 { {

106 "latitude": 20.75, "latitude": 20.75,

107 "longitude": 116.75, "longitude": 116.75,

108 "time": "2025-07-05T06:00:00Z" "time": "2025-07-05T06:00:00Z"

109 }, },

110 { {

111 "latitude": 20.5, "latitude": 20.5,

112 "longitude": 116.75, "longitude": 116.75,

113 "time": "2025-07-05T12:00:00Z" "time": "2025-07-05T12:00:00Z"

114 }, },

115 { {

116 "latitude": 20.75, "latitude": 20.75,

117 "longitude": 116.75, "longitude": 116.75,

118 "time": "2025-07-05T18:00:00Z" "time": "2025-07-05T18:00:00Z"

119 }, },

120 { {

121 "latitude": 21.25, "latitude": 21.25,

122 "longitude": 117, "longitude": 117,

123 "time": "2025-07-06T00:00:00Z" "time": "2025-07-06T00:00:00Z"

124 }, },

125 { {

126 "latitude": 21.5, "latitude": 21.5,

127 "longitude": 117.5, "longitude": 117.5,

128 "time": "2025-07-06T06:00:00Z" "time": "2025-07-06T06:00:00Z"

129 }, },

130 { {

131 "latitude": 22.25, "latitude": 22.25,

132 "longitude": 117.75, "longitude": 117.75,

133 "time": "2025-07-06T12:00:00Z" "time": "2025-07-06T12:00:00Z"

134 }, },

135 { {

136 "latitude": 23, "latitude": 23,

137 "longitude": 118.5, "longitude": 118.5,

138 "time": "2025-07-06T18:00:00Z" "time": "2025-07-06T18:00:00Z"

139 }, },

140 { {

141 "latitude": 23.75, "latitude": 23.75,

142 "longitude": 119.25, "longitude": 119.25,

143 "time": "2025-07-07T00:00:00Z" "time": "2025-07-07T00:00:00Z"

144 }, },

145 { {

146 "latitude": 25.25, "latitude": 25.25,

147 "longitude": 120.75, "longitude": 120.75,

148 "time": "2025-07-07T06:00:00Z" "time": "2025-07-07T06:00:00Z"

149 }, },

150 { {

151 "latitude": 26.25, "latitude": 26.25,

152 "longitude": 121.25, "longitude": 121.25,

153 "time": "2025-07-07T12:00:00Z" "time": "2025-07-07T12:00:00Z"

154 }, },

155 { {

156 "latitude": 27.25, "latitude": 27.25,

157 "longitude": 121.25, "longitude": 121.25,

158 "time": "2025-07-07T18:00:00Z" "time": "2025-07-07T18:00:00Z"

159 } }

160 ], ],

161 "MUN-2025070312": [ "MUN-2025070312": [

162 { {

163 "latitude": 28.5, "latitude": 28.5,

164 "longitude": 145, "longitude": 145,

165 "time": "2025-07-03T12:00:00Z" "time": "2025-07-03T12:00:00Z"

166 }, },

167 { {

168 "latitude": 29, "latitude": 29,

169 "longitude": 144.5, "longitude": 144.5,

170 "time": "2025-07-03T18:00:00Z" "time": "2025-07-03T18:00:00Z"

171 }, },

172 { {

173 "latitude": 29.25, "latitude": 29.25,

174 "longitude": 144.75, "longitude": 144.75,

175 "time": "2025-07-04T00:00:00Z" "time": "2025-07-04T00:00:00Z"

176 }, },

177 { {

178 "latitude": 29.75, "latitude": 29.75,

179 "longitude": 144.75, "longitude": 144.75,

180 "time": "2025-07-04T06:00:00Z" "time": "2025-07-04T06:00:00Z"

181 }, },

182 { {

183 "latitude": 30.25, "latitude": 30.25,

184 "longitude": 145.25, "longitude": 145.25,

185 "time": "2025-07-04T12:00:00Z" "time": "2025-07-04T12:00:00Z"

186 }, },

187 { {

188 "latitude": 30.75, "latitude": 30.75,

189 "longitude": 145.75, "longitude": 145.75,

190 "time": "2025-07-04T18:00:00Z" "time": "2025-07-04T18:00:00Z"

191 }, },

192 { {

193 "latitude": 31, "latitude": 31,

194 "longitude": 146.25, "longitude": 146.25,

195 "time": "2025-07-05T00:00:00Z" "time": "2025-07-05T00:00:00Z"

196 }, },

197 { {

198 "latitude": 31.5, "latitude": 31.5,

199 "longitude": 147, "longitude": 147,

200 "time": "2025-07-05T06:00:00Z" "time": "2025-07-05T06:00:00Z"

201 }, },

202 { {

203 "latitude": 31.75, "latitude": 31.75,

204 "longitude": 147.5, "longitude": 147.5,

205 "time": "2025-07-05T12:00:00Z" "time": "2025-07-05T12:00:00Z"

206 }, },

207 { {

208 "latitude": 32, "latitude": 32,

209 "longitude": 148, "longitude": 148,

210 "time": "2025-07-05T18:00:00Z" "time": "2025-07-05T18:00:00Z"

211 }, },

212 { {

213 "latitude": 32.5, "latitude": 32.5,

214 "longitude": 148.5, "longitude": 148.5,

215 "time": "2025-07-06T00:00:00Z" "time": "2025-07-06T00:00:00Z"

216 }, },

217 { {

218 "latitude": 33, "latitude": 33,

219 "longitude": 148.75, "longitude": 148.75,

220 "time": "2025-07-06T06:00:00Z" "time": "2025-07-06T06:00:00Z"

221 }, },

222 { {

223 "latitude": 33.5, "latitude": 33.5,

224 "longitude": 149, "longitude": 149,

225 "time": "2025-07-06T12:00:00Z" "time": "2025-07-06T12:00:00Z"

226 }, },

227 { {

228 "latitude": 34.5, "latitude": 34.5,

229 "longitude": 149, "longitude": 149,

230 "time": "2025-07-06T18:00:00Z" "time": "2025-07-06T18:00:00Z"

231 }, },

232 { {

233 "latitude": 35.25, "latitude": 35.25,

234 "longitude": 148.75, "longitude": 148.75,

235 "time": "2025-07-07T00:00:00Z" "time": "2025-07-07T00:00:00Z"

236 }, },

237 { {

238 "latitude": 35.75, "latitude": 35.75,

239 "longitude": 148.25, "longitude": 148.25,

240 "time": "2025-07-07T06:00:00Z" "time": "2025-07-07T06:00:00Z"

241 } }

242 ] ]

243 }}