HIhighlightly
American Football.Matches

Get match by id

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

Fetched data will have additional information about the venue, weather forecast, matchStatistics for each team, injuries, events, topPerformers, player boxScores and matchStatistics.

Note: Used to retrieve additional match information.

get/american-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
leaguestring required
seasonnumber required

Example response

[
  {
    "id": 1,
    "round": "Regular Season - 32",
    "date": "2023-05-20T15:30:00.000Z",
    "league": "NFL",
    "season": 2023,
    "awayTeam": {
      "id": 1,
      "logo": "https://example.com/logos/team/111.png",
      "name": "Saints",
      "displayName": "New Orleans Saints",
      "abbreviation": "NO"
    },
    "homeTeam": {
      "id": 1,
      "logo": "https://example.com/logos/team/111.png",
      "name": "Saints",
      "displayName": "New Orleans Saints",
      "abbreviation": "NO"
    },
    "state": {
      "period": 2,
      "clock": 8,
      "description": "In progress",
      "score": {
        "current": "21 - 7",
        "firstPeriod": "0 - 0",
        "secondPeriod": "7 - 7",
        "thirdPeriod": "7 - 0",
        "fourthPeriod": "7 - 0",
        "firstOvertimePeriod": "7 - 0",
        "secondOvertimePeriod": "7 - 0"
      },
      "report": "Final"
    },
    "venue": {
      "city": "Baltimore",
      "name": "M&T Bank Stadium",
      "state": "MD"
    },
    "forecast": {
      "status": "cloudy",
      "temperature": "11.97°C"
    },
    "matchStatistics": {
      "homeTeam": {
        "statistics": [
          {
            "name": "Rushing Attempts",
            "value": 34
          }
        ]
      },
      "awayTeam": {
        "statistics": [
          {
            "name": "Rushing Attempts",
            "value": 34
          }
        ]
      }
    },
    "injuries": [
      {
        "team": {
          "id": 35,
          "logo": "https://highlightly.net/american-football/images/teams/35.png",
          "name": "Saints",
          "league": "NFL",
          "displayName": "New Orleans Saints",
          "abbreviation": "NO"
        },
        "data": [
          {
            "status": "Questionable",
            "player": {
              "name": "Alvin Kamara",
              "jersey": 41,
              "position": "Running Back"
            }
          }
        ]
      }
    ],
    "events": [
      {
        "end": {
          "clock": "11:43",
          "period": "1st quarter",
          "yardLine": 40
        },
        "team": {
          "id": 35,
          "logo": "https://highlightly.net/american-football/images/teams/35.png",
          "name": "Saints",
          "league": "NFL",
          "displayName": "New Orleans Saints",
          "abbreviation": "NO"
        },
        "start": {
          "clock": "11:43",
          "period": "1st quarter",
          "yardLine": 40
        },
        "result": "Punt",
        "description": "5 plays, 6 yards, 3:17"
      }
    ],
    "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%"
          }
        }
      ]
    }
  }
]

Changes

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