Timeline

Parameters

Name	What it does	Example
`id`path, required	The ID in the path.	mt_064VTQ5
`type`enum, optional	Only one event type: try, penalty_try, conversion, penalty_goal, drop_goal, yellow_card, red_card.	try

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

Included.

Live

Included.

Response fields

Field	Meaning
`status`	complete, short, over, partial or none
`count`	Events returned
`data[].id`	Permanent event ID
`data[].minute, minute_extra`	Minute, plus added time where given
`data[].type`	try, penalty_try, conversion, penalty_goal, drop_goal, yellow_card, red_card
`data[].side`	home or away
`data[].player`	Player ID and name, or null
`data[].points`	Points the event scored
`data[].score`	Home and away score after the event

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 Archive.
`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/timeline?type=try \
  -H "Authorization: Bearer YOUR_KEY"

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

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

200ResponseExample from the live archive, lists cut to 3

{
  "match": "mt_064VTQ5",
  "status": "complete",
  "count": 4,
  "data": [
    {
      "id": "ev_2C76J2N",
      "minute": 7,
      "minute_extra": null,
      "type": "try",
      "side": "away",
      "player": {
        "id": "pl_2TS991Z",
        "name": "Tom Bowen"
      },
      "points": 5,
      "score": {
        "home": 0,
        "away": 5
      }
    },
    {
      "id": "ev_2ZJS64Y",
      "minute": 20,
      "minute_extra": null,
      "type": "try",
      "side": "away",
      "player": {
        "id": "pl_2TS991Z",
        "name": "Tom Bowen"
      },
      "points": 5,
      "score": {
        "home": 0,
        "away": 12
      }
    },
    {
      "id": "ev_0E7JXMP",
      "minute": 31,
      "minute_extra": null,
      "type": "try",
      "side": "away",
      "player": {
        "id": "pl_36XZVEX",
        "name": "Josh Adams"
      },
      "points": 5,
      "score": {
        "home": 0,
        "away": 19
      }
    }
  ]
}

PreviousLineups NextFixtures