Getting started
API keys
Before you can access WindBorne's weather data, you'll need to obtain API keys. Only the forecast endpoints and endpoints providing metadata are free to use.
You can get your API keys here and learn more about authentication here.
Basic authentication
WindBorne uses HTTP Basic Authentication. You can authenticate your requests using your client ID and API key.
curl -u 'WB_CLIENT_ID:WB_API_KEY' 'URL'curl -u 'WB_CLIENT_ID:WB_API_KEY' 'URL'
CLI and Python library
WindBorne releases a pip installable library built to interact with Data and Forecasts APIs that comes with a Command Line Interface (CLI) out of the box.
pip3 install windbornepip3 install windborne
Test API call
Let's test your authentication by making a call to the initialization times endpoint. This endpoint returns the available initialization times for point forecasts.
curl -u 'WB_CLIENT_ID:WB_API_KEY' 'https://api.windbornesystems.com/forecasts/v1/wm-4/initialization-times.json'curl -u 'WB_CLIENT_ID:WB_API_KEY' 'https://api.windbornesystems.com/forecasts/v1/wm-4/initialization-times.json'
Example successful response
OK
content-type: application/json
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
1 {{
2 "available": [ "available": [
3 "2025-05-17T18:00:00Z", "2025-05-17T18:00:00Z",
4 "2025-05-17T12:00:00Z", "2025-05-17T12:00:00Z",
5 "2025-05-17T06:00:00Z", "2025-05-17T06:00:00Z",
6 "2025-05-17T00:00:00Z", "2025-05-17T00:00:00Z",
7 "2025-05-16T18:00:00Z", "2025-05-16T18:00:00Z",
8 "2025-05-16T12:00:00Z", "2025-05-16T12:00:00Z",
9 "2025-05-16T06:00:00Z", "2025-05-16T06:00:00Z",
10 "2025-05-16T00:00:00Z" "2025-05-16T00:00:00Z"
11 ], ],
12 "latest": "2025-05-17T18:00:00Z" "latest": "2025-05-17T18:00:00Z"
13 }}
Example error response
Authentication Error
content-type: application/json
1 {{
2 "error": "Not authorized", "error": "Not authorized",
3 "success": false "success": false
4 }}