> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sportsapipro.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Rugby V2 API Overview

> Enhanced Rugby API with 115 endpoints: Union & League coverage including NRL, Super Rugby, Six Nations, and Rugby World Cup

## Base URL

```
https://api.sportsapipro.com/v2/rugby
```

## Authentication

All requests require an `x-api-key` header:

```bash theme={null}
curl -X GET "https://api.sportsapipro.com/v2/rugby/live" \
  -H "x-api-key: YOUR_API_KEY"
```

## 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

| Play                | Points             |
| ------------------- | ------------------ |
| Try                 | 5                  |
| Conversion          | 2                  |
| Penalty Goal        | 3                  |
| Drop Goal           | 3                  |
| Penalty Try (Union) | 7 (auto-converted) |

### 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

| Entity     | Name                 | ID    |
| ---------- | -------------------- | ----- |
| Tournament | NRL                  | 294   |
| Tournament | Super Rugby Pacific  | 376   |
| Tournament | Six Nations          | 20    |
| Tournament | Rugby World Cup      | 19    |
| Season     | NRL 2026             | 86317 |
| Team       | New Zealand Warriors | 4267  |
| Team       | Canberra Raiders     | 4256  |
| Team       | Sydney Roosters      | 4266  |

## Endpoint Categories

| Category                                                     | Count   | Description                     |
| ------------------------------------------------------------ | ------- | ------------------------------- |
| [Live & Schedule](/api-reference/rugby-v2/global)            | 7       | Real-time scores and scheduling |
| [Search & Discovery](/api-reference/rugby-v2/global)         | 7       | Search, categories, trending    |
| [Tournament](/api-reference/rugby-v2/tournament)             | 27      | League info, standings, seasons |
| [Match](/api-reference/rugby-v2/match)                       | 26      | Match details, stats, incidents |
| [Team](/api-reference/rugby-v2/team)                         | 15      | Rosters, form, transfers        |
| [Player](/api-reference/rugby-v2/player)                     | 18      | Career stats, transfer history  |
| [Manager / Referee / Venue](/api-reference/rugby-v2/manager) | 15      | Coaches, officials, grounds     |
| **Total**                                                    | **115** |                                 |

## 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

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://api.sportsapipro.com/v2/rugby/live" \
    -H "x-api-key: YOUR_API_KEY"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://api.sportsapipro.com/v2/rugby/live',
    { headers: { 'x-api-key': 'YOUR_API_KEY' } }
  );
  const data = await response.json();
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://api.sportsapipro.com/v2/rugby/live',
      headers={'x-api-key': 'YOUR_API_KEY'}
  )
  data = response.json()
  ```
</CodeGroup>

## 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

| Feature       | Rugby                                               | Football (Soccer) | Basketball      |
| ------------- | --------------------------------------------------- | ----------------- | --------------- |
| Match format  | 2 × 40 min (Union) / 2 × 35 min (League)            | 2 × 45 min        | 4 × 12 min      |
| Score range   | 10-40 per team typical                              | 0-5 typical       | 80-120 typical  |
| Score fields  | period1-period2 (halves)                            | period1-period2   | period1-period4 |
| Scoring plays | Try (5), Conversion (2), Penalty (3), Drop Goal (3) | Goals             | FG, FT, 3PT     |
| Key stats     | Tries, tackles, carries, metres gained              | Possession, shots | FG%, rebounds   |
| Squad         | 15 + 8 bench (Union) / 13 + 4 bench (League)        | 11 + 3 subs       | 5 + 7 bench     |
| Cards         | Yellow (10 min sin bin), Red (sent off)             | Yellow/Red        | Technical fouls |