API Overview

The Spire Weather API provides programmatic access to global weather data products. This guide covers authentication, the Base URL, and core concepts.

Base URL¶

All API endpoints are relative to:

https://api.wx.spire.com

Authentication¶

An API Key is required for all requests. Include your key in the spire-api-key header:

curl -X GET 'https://api.wx.spire.com/forecast/point?lat=40.0&lon=-105.0' \
  -H 'spire-api-key: YOUR_API_KEY'

import requests

response = requests.get(
    "https://api.wx.spire.com/forecast/point",
    params={"lat": 40.0, "lon": -105.0},
    headers={"spire-api-key": "YOUR_API_KEY"},
)
data = response.json()

const response = await fetch(
  "https://api.wx.spire.com/forecast/point?lat=40.0&lon=-105.0",
  { headers: { "spire-api-key": "YOUR_API_KEY" } }
);
const data = await response.json();

Response Format¶

All API responses are returned as JSON (except file downloads). A typical response includes:

{
  "meta": {
    "unit_system": "si",
    "forecast": "Spire Operational Forecast"
  },
  "data": [...]
}

Available Endpoints¶

The API is organized into the following categories:

Common Parameters¶

Many endpoints share common query parameters:

Rate Limits¶

API requests are subject to rate limiting based on your subscription tier. If you exceed your rate limit, you’ll receive a 429 Too Many Requests response.

Error Handling¶

The API uses standard HTTP status codes:

Error responses include details:

{
  "error": {
    "code": "INVALID_PARAMETER",
    "message": "Latitude must be between -90 and 90"
  }
}

Next Steps¶

• Quick Start Guide - Make your first API call

• File Products Guide - Download forecast files

• API Reference - Complete endpoint documentation