HIhighlightly
Football.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, weather forecast, match statistics, match news and who the game's referee is. The retrieved data will also contain a list of important events that happened:

TypeDescription
GoalA player strikes the ball into the opposing team's goal.
Own GoalA player strikes or deflects the ball into their own team's goal.
PenaltyA player scores the goal from the penalty spot after a foul or hand play by the defending team inside the penalty area.
Missed PenaltyThe player taking the penalty kick failed to score, either by missing the target or the shot being saved by the goalkeeper.
Yellow CardA player is cautioned by the referee for unsporting behavior or foul play.
Red CardA player is sent off the field for serious foul play, violent conduct, or receiving a second yellow card.
SubstitutionA player is replaced by another player from the bench during a stoppage in play.
VAR Goal ConfirmedThe Video Assistant Referee (VAR) review confirms that a goal is valid and should stand.
VAR Goal CancelledThe VAR review determines that a goal should be disallowed due to an infringement or violation.
VAR PenaltyThe VAR review results in a penalty being awarded to a team.
VAR Penalty CancelledThe VAR review results in a previously awarded penalty being overturned.
VAR Goal Cancelled - OffsideThe VAR review determines that a goal should be disallowed due to an offside infringement.

The above list may be updated with additional entries in the future.

Note: Used to retrieve additional match information.

get/football/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
roundstring required
datestring required

Example response

[
  {
    "id": 1002433681,
    "round": "Apertura - 9",
    "date": "\"2024-03-31T20:30:00.000Z",
    "country": {
      "code": "FR",
      "name": "France",
      "logo": "https://example.com/logos/country/FR.png"
    },
    "awayTeam": {
      "id": 553,
      "logo": "https://example.com/logos/team/553.png",
      "name": "Montpellier",
      "shots": [
        {
          "playerName": "Cody Gakpo",
          "time": "3'",
          "outcome": "Missed",
          "goalTarget": "High Right"
        }
      ],
      "topPlayers": [
        {
          "position": "Midfielder",
          "name": "Carlos Augusto",
          "statistics": [
            {
              "name": "Shots On Target"
            }
          ]
        }
      ]
    },
    "homeTeam": {
      "id": 553,
      "logo": "https://example.com/logos/team/553.png",
      "name": "Montpellier",
      "shots": [
        {
          "playerName": "Cody Gakpo",
          "time": "3'",
          "outcome": "Missed",
          "goalTarget": "High Right"
        }
      ],
      "topPlayers": [
        {
          "position": "Midfielder",
          "name": "Carlos Augusto",
          "statistics": [
            {
              "name": "Shots On Target"
            }
          ]
        }
      ]
    },
    "league": {
      "id": 133,
      "season": 2023,
      "name": "Ligue 1",
      "logo": "https://example.com/logos/league/133.png"
    },
    "state": {
      "description": "Second half",
      "clock": 67,
      "score": {
        "current": "3 - 1",
        "penalties": "6 - 4"
      }
    },
    "events": [
      {
        "team": {
          "id": 13394673,
          "logo": "https://example.com/logo/preview/66311.13394673",
          "name": "Tersana"
        },
        "time": "45+1",
        "type": "Goal",
        "playerId": 63606907,
        "player": "M. Mamdouh",
        "assist": "J. Johanson"
      }
    ],
    "statistics": [
      {
        "team": {
          "id": 553,
          "logo": "https://example.com/logos/team/553.png",
          "name": "Montpellier"
        },
        "statistics": [
          {
            "value": 0.62,
            "displayName": "Shots accuracy"
          }
        ]
      }
    ],
    "referee": {
      "name": "Brace, Andrew",
      "nationality": "Ireland"
    },
    "venue": {
      "city": "Swansea",
      "name": "Liberty Stadium",
      "country": "Wales",
      "capacity": "20827"
    },
    "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%"
          }
        }
      ]
    },
    "news": [
      {
        "url": "https://football-italia.net/watch-milan-reijnders-scores-16th-goal-2024-25/?utm_source=365Scores&utm_medium=link&utm_campaign=Contact%2bus%2bat%2b365scores%2bfor%2bmore%2btraffic",
        "image": "https://icdn.football-italia.net/wp-content/uploads/2025/03/netherlands-v-spain-uefa-nations.jpg",
        "title": "Celebrating Fernando Torres: A Spanish Football Icon",
        "datePublished": "2025-03-20T19:29:02Z"
      }
    ]
  }
]

Changes

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