Weather
LiveResults by the conditions at kickoff: rain, wind and temperature, with points, tries and home wins.
Parameters
| Name | What it does | Example |
|---|---|---|
teamstring, optional | Only matches this team played in. | |
competitionstring, optional | Only this competition. IDs come from Competitions. | |
seasonstring, optional | Only this season. IDs come from a competition's Seasons. | ss_2H1294N |
Any other parameter is refused with a 422 naming the ones this endpoint takes, so a typo never silently returns everything.
What each plan returns
Free key
Not included. Returns 403 with the upgrade link.
Archive
Not included. Returns 403 with the upgrade link.
Live
Included.
Response fields
| Field | Meaning |
|---|---|
analysis | Which analysis this is, for example totals. |
scope | The team, competition and season asked for, each with its ID and name, or null. |
basis.matches_in_scope | Finished matches in the scope. |
basis.matches_counted | How many of them this analysis could use. |
basis.counted | The rule for which matches count, for example only those whose scoring timeline adds up to the final score. |
notes | How the figures are worked out, in plain words. |
data | The figures. With a team, the team's own; without one, the whole scope with a row per team. |
built_utc | When the answer was worked out. Each scope is kept for three hours. |
Errors you can get
| Status | Code | When |
|---|---|---|
400 | key_in_address | The key was put in the address. Send it in a header (see Authentication). |
401 | missing_key | No Authorization: Bearer header, or the key was rotated (invalid_key, revoked_key). |
403 | plan_required | Your plan is below Live. |
422 | bad_parameter | A parameter is malformed, or unknown (unknown_parameter names the ones this endpoint takes). |
422 | missing_parameter | None of team, competition or season was given. A team can be combined with a competition or a season. |
429 | daily_limit | Today's lookups are used. Resets at 00:00 UTC. |
Every error has the same shape. All error codes
Try it live
Runs this call from your browser with your own key and shows what comes back.
curl https://api.rugbyapi.com/v1/analytics/weather?season=ss_2H1294N \
-H "Authorization: Bearer YOUR_KEY"$ch = curl_init('https://api.rugbyapi.com/v1/analytics/weather?season=ss_2H1294N'); curl_setopt_array($ch, [ CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_KEY'], CURLOPT_RETURNTRANSFER => true, ]); $data = json_decode(curl_exec($ch), true);
import requests r = requests.get( "https://api.rugbyapi.com/v1/analytics/weather", params={"season": "ss_2H1294N"}, headers={"Authorization": "Bearer YOUR_KEY"}, ) data = r.json()
const r = await fetch('https://api.rugbyapi.com/v1/analytics/weather?season=ss_2H1294N', { headers: { Authorization: 'Bearer YOUR_KEY' } }); const data = await r.json();
200ResponseExample from the live archive, lists cut to 3
{
"analysis": "weather",
"scope": {
"team": null,
"competition": {
"id": "cp_2EW9542",
"name": "United Rugby Championship"
},
"season": {
"id": "ss_2H1294N",
"name": "2025-26"
}
},
"basis": {
"matches_in_scope": 151,
"matches_counted": 133,
"counted": "Finished matches with weather recorded for the kickoff hour at the nearest station. Tries, conversions and penalty goals come from those whose scoring timeline adds up."
},
"notes": [
"Rain is millimetres in the kickoff hour: dry is none, light rain up to 1 mm, rain above that. Wind is the mean speed: calm under 15 km/h, breezy 15 to 29, windy 30 or more.",
"Temperature: cold under 8 C, mild 8 to 17, warm 18 to 24, hot 25 or more. Weather is observed at the station nearest the ground, not inside it, and a roofed ground is not set apart."
],
"data": {
"matches": 133,
"rain": [
{
"band": "dry",
"matches": 102,
"avg_total_points": 47.9,
"home_win_pct": 71.6,
"matches_with_timeline": 100,
"tries_per_match": 6.89,
"conversion_rate_pct": 68.1,
"penalty_goals_per_match": 1.24
},
{
"band": "light rain",
"matches": 24,
"avg_total_points": 48.2,
"home_win_pct": 66.7,
"matches_with_timeline": 23,
"tries_per_match": 7,
"conversion_rate_pct": 73.9,
"penalty_goals_per_match": 0.74
},
{
"band": "rain",
"matches": 7,
"avg_total_points": 53.4,
"home_win_pct": 57.1,
"matches_with_timeline": 7,
"tries_per_match": 6.71,
"conversion_rate_pct": 70.2,
"penalty_goals_per_match": 3.29
}
],
"wind": [
{
"band": "calm",
"matches": 81,
"avg_total_points": 49,
"home_win_pct": 66.7,
"matches_with_timeline": 78,
"tries_per_match": 7.04,
"conversion_rate_pct": 69.4,
"penalty_goals_per_match": 1.21
},
{
"band": "breezy",
"matches": 40,
"avg_total_points": 46.6,
"home_win_pct": 82.5,
"matches_with_timeline": 40,
"tries_per_match": 6.75,
"conversion_rate_pct": 68.5,
"penalty_goals_per_match": 1.15
},
{
"band": "windy",
"matches": 12,
"avg_total_points": 48.3,
"home_win_pct": 50,
"matches_with_timeline": 12,
"tries_per_match": 6.5,
"conversion_rate_pct": 70.5,
"penalty_goals_per_match": 2
}
],
"temperature": [
{
"band": "cold",
"matches": 37,
"avg_total_points": 42.6,
"home_win_pct": 67.6,
"matches_with_timeline": 36,
"tries_per_match": 6.03,
"conversion_rate_pct": 68.7,
"penalty_goals_per_match": 1.28
},
{
"band": "mild",
"matches": 62,
"avg_total_points": 47.9,
"home_win_pct": 62.9,
"matches_with_timeline": 61,
"tries_per_match": 6.89,
"conversion_rate_pct": 68.8,
"penalty_goals_per_match": 1.16
},
{
"band": "warm",
"matches": 26,
"avg_total_points": 55.7,
"home_win_pct": 84.6,
"matches_with_timeline": 26,
"tries_per_match": 8.12,
"conversion_rate_pct": 70.6,
"penalty_goals_per_match": 1.15
}
]
},
"built_utc": "2026-10-22T03:17:29Z"
}