HIhighlightly
Rugby.Matches

Get match by id

Retrieve detailed match information by specifying the match id path parameter.

Certain popular leagues and their associated matches will have additional data about the venue, match weather forecast, who the game's referee is and lineups.

Every player on the team, whether in the starting lineup or on the bench, is assigned a specific position type:

PositionDescription
ForwardCompetes for possession in scrums and rucks.
BackHandles attacking and passing play.
Full BackDefends deep and returns kicks.
PropFront-row player in the scrum.
Unknown (null)Position not specified or unclear.

Note: Used to retrieve additional match information.

get/rugby/matches/{id}

Request

Path parameters

idnumber required

Requested match id.

Headers

x-rapidapi-hoststring required

sport-highlights-api.p.rapidapi.com

x-rapidapi-keystring required

Rapid API Token

Response

idnumber required
weekstring
datestring required

Example response

[
  {
    "id": 36125734,
    "week": "14",
    "date": "2024-03-30T15:00:00.000Z",
    "country": {
      "code": "EU",
      "name": "Europe",
      "logo": "https://example.com/logos/country/EU.png"
    },
    "awayTeam": {
      "id": 384585,
      "logo": "https://example.com/logos/team/90990.png",
      "name": "Italy U20"
    },
    "homeTeam": {
      "id": 384585,
      "logo": "https://example.com/logos/team/90990.png",
      "name": "Italy U20"
    },
    "league": {
      "id": 48440,
      "season": 2024,
      "name": "Six Nations U20",
      "logo": "https://example.com/logos/league/48440.png"
    },
    "state": {
      "description": "Finished",
      "score": "47 - 14"
    },
    "venue": {
      "city": "Swansea",
      "name": "Liberty Stadium",
      "country": "Wales",
      "capacity": "20827"
    },
    "referee": {
      "name": "Brace, Andrew",
      "nationality": "Ireland"
    },
    "forecast": {
      "status": "cloudy",
      "temperature": "11.97°C"
    },
    "predictions": {
      "prematch": [
        {
          "type": "prematch",
          "modelType": "three-way",
          "generatedAt": "2025-03-12T19:00:20.000Z",
          "description": "Team A is most likely to win the game against Team B.`",
          "probabilities": {
            "home": "30.22%",
            "draw": "0.00%",
            "away": "69.78%"
          }
        }
      ],
      "live": [
        {
          "type": "prematch",
          "modelType": "three-way",
          "generatedAt": "2025-03-12T19:00:20.000Z",
          "description": "Team A is most likely to win the game against Team B.`",
          "probabilities": {
            "home": "30.22%",
            "draw": "0.00%",
            "away": "69.78%"
          }
        }
      ]
    },
    "lineups": {
      "home": {
        "initialLineup": [
          {
            "name": "Andrew Porter",
            "shortName": "A. Porter",
            "countryName": "Ireland",
            "birth": "1996-01-16T00:00:00.000Z",
            "height": "183 cm",
            "position": "Forward",
            "shirtNumber": 1
          }
        ],
        "substitutions": [
          {
            "name": "Andrew Porter",
            "shortName": "A. Porter",
            "countryName": "Ireland",
            "birth": "1996-01-16T00:00:00.000Z",
            "height": "183 cm",
            "position": "Forward",
            "shirtNumber": 1
          }
        ]
      },
      "away": {
        "initialLineup": [
          {
            "name": "Andrew Porter",
            "shortName": "A. Porter",
            "countryName": "Ireland",
            "birth": "1996-01-16T00:00:00.000Z",
            "height": "183 cm",
            "position": "Forward",
            "shirtNumber": 1
          }
        ],
        "substitutions": [
          {
            "name": "Andrew Porter",
            "shortName": "A. Porter",
            "countryName": "Ireland",
            "birth": "1996-01-16T00:00:00.000Z",
            "height": "183 cm",
            "position": "Forward",
            "shirtNumber": 1
          }
        ]
      }
    }
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.