Skip to main content

Base URL

Authentication

All requests require an x-api-key header:

Rugby-Specific Notes

Two Codes of Rugby

  • Rugby Union — 15-a-side, 2 × 40 minutes (e.g., Six Nations, Rugby World Cup, Super Rugby)
  • Rugby League — 13-a-side, 2 × 35 minutes (e.g., NRL, Super League)
Both codes are covered under the /api/ prefix.

Scoring System

Score Fields

Scores use half-by-half fields: period1 (1st half) and period2 (2nd half), plus extra time where applicable.

Positions

Forwards: Loosehead Prop (1), Hooker (2), Tighthead Prop (3), Lock (4,5), Blindside Flanker (6), Openside Flanker (7), Number 8 (8) Backs: Scrumhalf (9), Flyhalf (10), Left Wing (11), Inside Centre (12), Outside Centre (13), Right Wing (14), Fullback (15)

Squad Sizes

  • Union: 15 starters + 8 bench = 23 players
  • League: 13 starters + 4 bench = 17 players

Cards

  • Yellow card — 10-minute sin bin (temporary suspension)
  • Red card — sent off for remainder of match

Seasonality

  • NRL (League): February – October
  • Six Nations (Union): February – March
  • Super Rugby (Union): February – June
  • Rugby World Cup: Every 4 years (Sep–Nov)
There’s almost always live rugby somewhere in the world.

Key Test IDs

Endpoint Categories

Key Statistics

  • Tackles — total, missed, dominant
  • Carries — metres gained, post-contact metres
  • Tries — scored, assists
  • Penalties — conceded, won
  • Lineout — won/lost, steals
  • Scrums — won/lost, penalties

Example Requests

UI Design Ideas

  • Score display: Show half-by-half (HT: 14-7, FT: 28-21) — use /match/{id}/scores
  • Scoring breakdown: Tries, conversions, penalties, drop goals — use /match/{id}/incidents
  • Key stats: Tackles made, metres carried, line breaks, penalties conceded, possession %
  • Player positions: Forwards (1-8) and Backs (9-15) — group in lineups view
  • Cards: Yellow = 10 min sin bin, Red = sent off — use /match/{id}/incidents
  • Man of the Match: Important in rugby culture — use /match/{id}/award
  • International: Use /players/{id}/national-team-statistics for caps and international stats
  • Multiple codes: NRL = Rugby League (13-a-side), Six Nations = Rugby Union (15-a-side). Both covered.

Sport Comparison — Rugby vs Football vs Basketball

Last modified on June 29, 2026