{"openapi":"3.1.0","info":{"title":"Rugby API","version":"1.0.0","description":"Live rugby union data for the top competitions as an API — clean JSON, no key. Get the full league table for any competition (played, won, drawn, lost, points for/against, tries, bonus points and league points), list every team and open a team for its record and colours, pull matches and results for any date, and open a match for its detail. Read league news too. Covers the Gallagher Premiership, United Rugby Championship, French Top 14, European Champions Cup, Super Rugby Pacific, the Rugby Championship and the Rugby World Cup — pass the league id (see /v1/leagues). Live data sourced continuously from ESPN. A global sport with passionate fanbases across Europe and the Southern Hemisphere — ideal for score apps, league-table widgets, fantasy and betting tools, dashboards and Discord bots. 7 data endpoints. Authenticated with an x-oanor-key; fair-use rate limits per plan.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/rugby-api","description":"oanor gateway"}],"tags":[{"name":"Reference"},{"name":"Standings"},{"name":"Matches"},{"name":"Teams"},{"name":"News"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/leagues":{"get":{"operationId":"get_v1_leagues","tags":["Reference"],"summary":"Supported leagues","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":7,"leagues":[{"id":"164205","name":"Rugby World Cup"},{"id":"242041","name":"Super Rugby Pacific"},{"id":"244293","name":"The Rugby Championship"},{"id":"267979","name":"Gallagher Premiership"},{"id":"270557","name":"United Rugby Championship"},{"id":"270559","name":"French Top 14"},{"id":"271937","name":"European Rugby Champions Cup"}]},"meta":{"timestamp":"2026-06-08T01:20:16.111Z","request_id":"2eddde8a-cdde-47b9-93b3-ed9e15766f1d"},"status":"ok","message":"Leagues retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/standings":{"get":{"operationId":"get_v1_standings","tags":["Standings"],"summary":"League table","description":"","parameters":[{"name":"league","in":"query","required":false,"description":"League id (e.g. 267979 Premiership, 270557 URC, 270559 Top 14) — see /v1/leagues","schema":{"type":"string"},"example":"267979"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":10,"table":[{"id":"25907","logo":"https://a.espncdn.com/i/teamlogos/rugby/teams/500/25907.png","rank":1,"team":"Northampton Saints","wins":14,"draws":1,"losses":3,"played":18,"tries_for":104,"points_for":693,"bonus_points":16,"league_points":74,"tries_against":77,"points_against":536,"points_difference":157},{"id":"25898","logo":"https://a.espncdn.com/i/teamlogos/rugby/teams/500/25898.png","rank":2,"team":"Bath Rugby","wins":13,"draws":0,"losses":5,"played":18,"tries_for":98,"points_for":646,"bonus_points":17,"league_points":69,"tries_against":60,"points_against":424,"points_difference":222},{"id":"116227","logo":"https://a.espncdn.com/i/teamlogos/rugby/teams/500/116227.png","rank":3,"team":"Exeter Chiefs","wins":11,"draws":1,"losses":6,"played":18,"tries_for":72,"points_for":521,"bonus_points":19,"league_points":65,"tries_against":51,"points_against":367,"points_difference":154},{"id":"25903","logo":"https://a.espncdn.com/i/teamlogos/rugby/teams/500/25903.png","rank":4,"team":"Leicester Tigers","wins":12,"draws":0,"losses":6,"played":18,"tries_for":82,"points_for":583,"bonus_points":15,"league_points":63,"tries_against":56,"points_against":405,"points_difference":178},{"id":"25909","logo":"https://a.espncdn.com/i/teamlogos/rugby/teams/500/25909.png","rank":5,"team":"Saracens","wins":10,"draws":0,"losses":8,"played":18,"tries_for":92,"points_for":628,"bonus_points":17,"league_points":57,"tries_against":64,"points_against":449,"points_difference":179},{"id":"25899","rank":6,"team":"Bristol Rugby","wins":11,"draws":0,"losses":7,"played":18,"tries_for":76,"points_for":525,"bonus_points":10,"league_points":54,"tries_against":74,"points_against":509,"points_difference":16},{"id":"25908","logo":"https://a.espncdn.com/i/teamlogos/rugby/teams/500/25908.png","rank":7,"team":"Sale Sharks","wins":5,"draws":0,"losses":13,"played":18,"tries_for":75,"points_for":524,"bonus_points":16,"league_points":36,"tries_against":90,"points_against":602,"points_difference":-78},{"id":"25900","logo":"https://a.espncdn.com/i/teamlogos/rugby/teams/500/25900.png","rank":8,"team":"Gloucester Rugby","wins":5,"draws":0,"losses":13,"played":18,"tries_for":64,"points_for":424,"bonus_points":12,"league_points":32,"tries_against":81,"points_against":576,"points_difference":-152},{"id":"25901","logo":"https://a.espncdn.com/i/teamlogos/rugby/teams/500/25901.png","rank":9,"team":"Harlequins","wins":6,"draws":0,"losses":12,"played":18,"tries_for":64,"points_for":448,"bonus_points":7,"league_points":31,"tries_against":90,"points_against":589,"points_difference":-141},{"id":"25906","logo":"https://a.espncdn.com/i/teamlogos/rugby/teams/500/25906.png","rank":10,"team":"Newcastle Falcons","wins":2,"draws":0,"losses":16,"played":18,"tries_for":47,"points_for":325,"bonus_points":4,"league_points":12,"tries_against":131,"points_against":860,"points_difference":-535}],"league":"267979","league_name":"Gallagher Premiership"},"meta":{"timestamp":"2026-06-08T01:20:16.309Z","request_id":"2d900b16-3da4-4748-8980-075c9dc2b2fb"},"status":"ok","message":"Standings retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/match":{"get":{"operationId":"get_v1_match","tags":["Matches"],"summary":"Match detail","description":"","parameters":[{"name":"league","in":"query","required":false,"description":"League id (e.g. 267979 Premiership, 270557 URC, 270559 Top 14) — see /v1/leagues","schema":{"type":"string"},"example":"267979"},{"name":"id","in":"query","required":true,"description":"Match id","schema":{"type":"string"},"example":"603070"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"match":{"id":"603070","name":"Northampton Saints vs Leicester Tigers","teams":[{"id":"25907","team":"Northampton Saints","winner":false,"home_away":"home","linescores":["0","0","0","0"]},{"id":"25903","team":"Leicester Tigers","winner":false,"home_away":"away","linescores":["0","0","0","0"]}],"venue":"cinch Stadium at Franklin's Gardens","status":"Scheduled"},"league":"267979"},"meta":{"timestamp":"2026-06-08T01:20:16.585Z","request_id":"1531d1be-ff83-4813-866f-7fd7e855a359"},"status":"ok","message":"Match retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/matches":{"get":{"operationId":"get_v1_matches","tags":["Matches"],"summary":"Matches & results","description":"","parameters":[{"name":"league","in":"query","required":false,"description":"League id (e.g. 267979 Premiership, 270557 URC, 270559 Top 14) — see /v1/leagues","schema":{"type":"string"},"example":"267979"},{"name":"dates","in":"query","required":false,"description":"Date range YYYYMMDD-YYYYMMDD","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":1,"league":"267979","matches":[{"id":"603070","away":{"id":"25903","logo":"https://a.espncdn.com/i/teamlogos/rugby/teams/500/25903.png","team":"Leicester Tigers","score":"0","winner":false,"home_away":"away","abbreviation":"LEI"},"date":"2026-06-12T18:45Z","home":{"id":"25907","logo":"https://a.espncdn.com/i/teamlogos/rugby/teams/500/25907.png","team":"Northampton Saints","score":"0","winner":false,"home_away":"home","abbreviation":"NOR"},"name":"Northampton Saints vs Leicester Tigers","clock":"1'","venue":"cinch Stadium at Franklin's Gardens","status":"Scheduled","completed":false}],"league_name":"Gallagher Premiership"},"meta":{"timestamp":"2026-06-08T01:20:16.785Z","request_id":"247f4ac2-4992-41a8-b867-81898aecd302"},"status":"ok","message":"Matches retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/team":{"get":{"operationId":"get_v1_team","tags":["Teams"],"summary":"Team detail","description":"","parameters":[{"name":"league","in":"query","required":false,"description":"League id (e.g. 267979 Premiership, 270557 URC, 270559 Top 14) — see /v1/leagues","schema":{"type":"string"},"example":"267979"},{"name":"id","in":"query","required":true,"description":"Team id","schema":{"type":"string"},"example":"25898"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"team":{"id":"25898","logo":"https://a.espncdn.com/i/teamlogos/rugby/teams/500/25898.png","name":"Bath Rugby","color":"000099","record":"WLWLL","nickname":"Bath Rugby","abbreviation":"BAT"},"league":"267979"},"meta":{"timestamp":"2026-06-08T01:20:17.079Z","request_id":"ce8a801c-1fb7-43d4-aa7e-1ed21817b1d3"},"status":"ok","message":"Team retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/teams":{"get":{"operationId":"get_v1_teams","tags":["Teams"],"summary":"Teams in a league","description":"","parameters":[{"name":"league","in":"query","required":false,"description":"League id (e.g. 267979 Premiership, 270557 URC, 270559 Top 14) — see /v1/leagues","schema":{"type":"string"},"example":"267979"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":10,"teams":[{"id":"25898","logo":"https://a.espncdn.com/i/teamlogos/rugby/teams/500/25898.png","name":"Bath Rugby","color":"000099","nickname":"Bath Rugby","abbreviation":"BAT"},{"id":"25899","name":"Bristol Rugby","nickname":"Bristol Rugby","abbreviation":"BRI"},{"id":"116227","logo":"https://a.espncdn.com/i/teamlogos/rugby/teams/500/116227.png","name":"Exeter Chiefs","color":"999999","nickname":"Exeter Chiefs","abbreviation":"EXE"},{"id":"25900","logo":"https://a.espncdn.com/i/teamlogos/rugby/teams/500/25900.png","name":"Gloucester Rugby","color":"FF0000","nickname":"Gloucester Rugby","abbreviation":"GLO"},{"id":"25901","logo":"https://a.espncdn.com/i/teamlogos/rugby/teams/500/25901.png","name":"Harlequins","color":"CCCCCC","nickname":"Harlequins","abbreviation":"HAR"},{"id":"25903","logo":"https://a.espncdn.com/i/teamlogos/rugby/teams/500/25903.png","name":"Leicester Tigers","color":"006633","nickname":"Leicester Tigers","abbreviation":"LEI"},{"id":"25906","logo":"https://a.espncdn.com/i/teamlogos/rugby/teams/500/25906.png","name":"Newcastle Falcons","color":"000000","nickname":"Newcastle Falcons","abbreviation":"NEW"},{"id":"25907","logo":"https://a.espncdn.com/i/teamlogos/rugby/teams/500/25907.png","name":"Northampton Saints","color":"006633","nickname":"Northampton Saints","abbreviation":"NOR"},{"id":"25908","logo":"https://a.espncdn.com/i/teamlogos/rugby/teams/500/25908.png","name":"Sale Sharks","color":"003366","nickname":"Sale Sharks","abbreviation":"SAL"},{"id":"25909","logo":"https://a.espncdn.com/i/teamlogos/rugby/teams/500/25909.png","name":"Saracens","color":"CC0000","nickname":"Saracens","abbreviation":"SAR"}],"league":"267979","league_name":"Gallagher Premiership"},"meta":{"timestamp":"2026-06-08T01:20:17.252Z","request_id":"91411590-01be-4c08-8ec5-df50486ab6b8"},"status":"ok","message":"Teams retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/news":{"get":{"operationId":"get_v1_news","tags":["News"],"summary":"League news","description":"","parameters":[{"name":"league","in":"query","required":false,"description":"League id (e.g. 267979 Premiership, 270557 URC, 270559 Top 14) — see /v1/leagues","schema":{"type":"string"},"example":"267979"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":0,"league":"267979","articles":[]},"meta":{"timestamp":"2026-06-08T01:20:17.468Z","request_id":"b106fa20-39fd-46cd-ac6c-c762a5a815be"},"status":"ok","message":"News retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"service":"rugby-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/news":"League news (league=).","GET /v1/team":"Team detail (league=, id=).","GET /v1/match":"Match detail by id (league=, id=).","GET /v1/teams":"Teams in a league (league=).","GET /v1/leagues":"Supported leagues and their ids.","GET /v1/matches":"Matches & results (league=, dates=).","GET /v1/standings":"League table (league=)."},"description":"Rugby union data for the top competitions: league tables/standings, teams, team detail, matches & results by date, full match detail and news — Gallagher Premiership, United Rugby Championship, French Top 14, Champions Cup, Super Rugby, the Rugby Championship and the Rugby World Cup. Real live data, no key."},"meta":{"timestamp":"2026-06-08T01:20:17.550Z","request_id":"077aa1e0-b143-420b-b710-9646cee2a2fb"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":3000,"rps_limit":5,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":720,"monthly_call_quota":53000,"rps_limit":15,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3000,"monthly_call_quota":285000,"rps_limit":30,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":9500,"monthly_call_quota":1250000,"rps_limit":80,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/rugby-api"}