API Documentation

Quick Start

Get started in under a minute. Sign up for free, grab your API key, and make your first request.

curl "https://confident-weather-api.onrender.com/weather/current?lat=51.5&lon=-0.1" \
  -H "Authorization: Bearer YOUR_API_KEY"

Authentication

All API requests require an API key. Include it in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Plans & Features

Free tier includes basic confidence scores. Paid plans unlock detailed probability breakdowns and forecast uncertainty data.

Feature	Free	Starter	Pro	Scale
Basic confidence score	✓	✓	✓	✓
Current weather	✓	✓	✓	✓
Forecast	✗	24h	72h	120h
Probability breakdowns	✗	✓	✓	✓
Detailed uncertainty data	✗	✓	✓	✓
Hourly interpolation	✗	✗	✓	✓
Multi-model ensemble	✗	✗	✗	✓

Endpoints

GET/weather/current

Get current weather with confidence scores.

Parameters

lat - Latitude (required)
lon - Longitude (required)

Example Response (Paid)

{
  "location": { "lat": 51.5, "lon": -0.1 },
  "overall": { "confidence": 78, "level": "high" },
  "temperature": {
    "value": 12.5,
    "confidence": 85,
    "range": [11.0, 14.0]
  },
  "precipitation": {
    "probability": 15,
    "confidence": 88,
    "membersPredictingRain": 8,
    "membersPredictingDry": 74
  },
  "weather": {
    "primary": "Mainly clear",
    "confidence": 90,
    "states": [
      { "name": "Mainly clear", "probability": 60 },
      { "name": "Overcast", "probability": 30 },
      { "name": "Light rain", "probability": 10 }
    ]
  },
  "wind": {
    "speed": 12.3,
    "confidence": 78,
    "range": [8.0, 18.0]
  }
}

Free tier response includes only confidence scores without detailed breakdowns (no range, membersPredicting*, or weather.states).

GET/weather/confidence

Get detailed confidence analysis for weather conditions.

Parameters

lat - Latitude (required)
lon - Longitude (required)

GET/weather/forecast

Get up to 7-day forecast with confidence scores.

Parameters

lat - Latitude (required)
lon - Longitude (required)
days - Number of days (1-7, optional)

Understanding Confidence

We run multiple weather models and compare their predictions. When models agree, confidence is high. When they disagree, you'll see the range of possibilities.

High (70-100)

Models strongly agree. Trust the forecast.

Medium (40-69)

Some disagreement. Use with caution.

Low (0-39)

High uncertainty. Consider alternatives.

Rate Limits

Plan	Price	Requests/Day
Free	$0	500
Starter	$19/mo	10,000
Pro	$49/mo	50,000
Scale	$199/mo	500,000

Error Handling

401 Unauthorized

Invalid or missing API key

429 Too Many Requests

Rate limit exceeded. Upgrade your plan or wait.

400 Bad Request

Missing required parameters (lat, lon)

View Pricing →Back to Top