Get a match

Free

One match in full: competition, season, round, venue, scores, half time and the quality flags. Add lineups and the timeline with include.

GEThttps://api.rugbyapi.com/v1/matches/{id}

Parameters

Name	What it does	Example
`id`path, required	The ID in the path.	mt_064VTQ5
`include`list, optional	Add lineups, timeline or both (comma separated) to the match. Needs Archive.	lineups,timeline

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

Matches from yesterday onwards, without include.

Archive

Any match, with lineups and timeline by include.

Live

Any match, with lineups and timeline by include.

Response fields

Field	Meaning
`id, date, kickoff_utc, status`	As in every match list
`competition, season`	ID and name of each
`round`	The round as the competition names it
`venue`	Name, city and country, or null
`home, away`	Team ID, name and score
`half_time`	Half-time score, or null where not published
`quality`	How complete the timeline and lineups are, and duplicate_of
`lineups, timeline`	Present when asked for with include

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`	The match is before yesterday, or include is used, on a free key.
`404`	`not_found`	No match with that ID (bad_id if it is not in our format).
`422`	`bad_parameter`	A parameter is malformed, or unknown (unknown_parameter names the ones this endpoint takes).
`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.

Your key Get a free key

curl https://api.rugbyapi.com/v1/matches/mt_064VTQ5 \
  -H "Authorization: Bearer YOUR_KEY"

$ch = curl_init('https://api.rugbyapi.com/v1/matches/mt_064VTQ5');
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/matches/mt_064VTQ5",
    headers={"Authorization": "Bearer YOUR_KEY"},
)
data = r.json()

const r = await fetch('https://api.rugbyapi.com/v1/matches/mt_064VTQ5', {
  headers: { Authorization: 'Bearer YOUR_KEY' }
});
const data = await r.json();

200ResponseExample from the live archive, lists cut to 3

{
  "id": "mt_064VTQ5",
  "date": "2026-10-31",
  "kickoff_utc": "2026-10-31T19:45:00Z",
  "status": "finished",
  "competition": {
    "id": "cp_2EW9542",
    "name": "United Rugby Championship"
  },
  "season": {
    "id": "ss_1VSX6S8",
    "name": "2026-27"
  },
  "home": {
    "id": "tm_1KTEF3F",
    "name": "Ospreys",
    "score": 0
  },
  "away": {
    "id": "tm_179VXFK",
    "name": "Cardiff Rugby",
    "score": 26
  },
  "round": "5",
  "venue": {
    "name": "St Helen's Rugby and Cricket Ground",
    "city": "Swansea",
    "country": "Wales",
    "lat": 51.612548,
    "lon": -3.966052
  },
  "half_time": {
    "home": 0,
    "away": 19
  },
  "referee": {
    "id": "rf_2PEH1TJ",
    "name": "Ben Breakspear",
    "union": "Wales",
    "union_basis": "wikipedia_box"
  },
  "attendance": 5592,
  "context": {
    "kickoff_basis": "match_page",
    "attendance_basis": "wikipedia",
    "attendance_wikipedia": 5592,
    "officials": null,
    "broadcaster": null,
    "ground": null,
    "weather": {
      "temp_c": 8.4,
      "rain_mm": 0,
      "wind_kmh": 13.7,
      "gust_kmh": null,
      "wind_dir": 67,
      "humidity": 94,
      "conditions": "fair",
      "station": "EGFH0 Swansea / Ilston",
      "station_km": 7.1,
      "hour_utc": "2026-10-31T20:00Z",
      "basis": "meteostat hourly, nearest station with data",
      "credit": "Meteostat and its data providers, CC BY 4.0, meteostat.net"
    },
    "light": {
      "at_kickoff": "dark",
      "sunset_utc": "2026-10-31T16:52:38Z",
      "basis": "computed"
    }
  },
  "quality": {
    "timeline": "complete",
    "lineups": "complete",
    "duplicate_of": null
  }
}

PreviousList matches NextLineups