MLB & NCAA API / matches

Get match by ID

GET https://baseball.highlightly.net/matches/{id} MLB & NCAA API
GET https://sports.highlightly.net/baseball/matches/{id} All Sports API

Retrieve detailed information for one match.

This is the detail view. Matches returns general information for a list of games, and this route fills in everything that route leaves out.

plays is the play by play record. Team totals are already in stats on this response, and are also available from match statistics. For the per player breakdown, use box scores.

Parameters

Parameter Type Description
idrequired numberpath Requested match id.

Request

curl --request GET \
  --url 'https://baseball.highlightly.net/matches/{id}' \
  --header 'x-rapidapi-key: YOUR_API_KEY'
const response = await fetch('https://baseball.highlightly.net/matches/{id}', {
  headers: {
    'x-rapidapi-key': process.env.HIGHLIGHTLY_API_KEY
  }
})

if (!response.ok) {
  throw new Error(`Highlightly responded ${response.status}`)
}

const data = await response.json()
import os
import requests

response = requests.get(
    'https://baseball.highlightly.net/matches/{id}',
    headers={
        'x-rapidapi-key': os.environ['HIGHLIGHTLY_API_KEY'],
    },
    timeout=10,
)

response.raise_for_status()
data = response.json()

Response

idnumberrequired
roundstringrequired
datestringrequired
leaguestringrequired
seasonnumberrequired
awayTeamBaseballMatchTeamResponserequired5 fields
idnumberrequired
logostring
namestring
displayNamestringrequired
abbreviationstringrequired
homeTeamBaseballMatchTeamResponserequired5 fields
idnumberrequired
logostring
namestring
displayNamestringrequired
abbreviationstringrequired
stateBaseballMatchStateResponserequired12 fields
descriptionstringrequiredFinishedPostponedPeriod EndRain DelayScheduledHalf TimeIn ProgressCanceledUnknownSuspendedAbandoned
reportstringAdditional description of the match state.
scoreBaseballMatchScoreResponserequired9 fields
homeBaseballMatchScorerequired3 fields
hitsnumber
errorsnumber
inningsstring[]requiredScores for each played inning.
awayBaseballMatchScorerequired3 fields
hitsnumber
errorsnumber
inningsstring[]requiredScores for each played inning.
currentstring
venueBaseballMatchVenueResponse3 fields
citystringrequired
namestringrequired
statestringrequired
statsBaseballMatchStatisticsResponse[]8 fields
teamBaseballMatchTeamStatisticsResponserequired7 fields
idnumberrequired
namestringrequired
logostring
statisticsBaseballTeamStatItemResponse[]required3 fields
namestringrequired
valuenumberrequired
groupstringrequired
playsBaseballDetailedMatchPlays[]32 fields
typestringrequired
teamIdnumberrequired
descriptionstringrequired
currentOutsnumberrequired
periodstringrequired
runnersBaseballDetailedMatchRunners9 fields
firstBaseballDetailedAthleteMinimal2 fields
fullNamestringrequired
playerIdnumberrequired
secondBaseballDetailedAthleteMinimal2 fields
fullNamestringrequired
playerIdnumberrequired
thirdBaseballDetailedAthleteMinimal2 fields
fullNamestringrequired
playerIdnumberrequired
pitcherBaseballDetailedAthleteMinimal2 fields
fullNamestringrequired
playerIdnumberrequired
batterBaseballDetailedAthleteMinimal2 fields
fullNamestringrequired
playerIdnumberrequired
pitchBaseballDetailedMatchPitchrequired4 fields
typestring
velocitynumber
ballsCountnumber
strikesCountnumber
resultBaseballDetailedMatchResultrequired2 fields
ballsCountnumber
strikesCountnumber
scoreBaseballDetailedMatchScoreAtPlayrequired2 fields
awaynumber
homenumber
refereesBaseballDetailedMatchReferees[]2 fields
namestringrequired
positionstringrequired
rostersBaseballDetailedMatchRosters10 fields
awayTeamBaseballDetailedMatchRosterSinglerequired4 fields
jerseynumber
fullNamestringrequired
positionstringrequired
isStarterbooleanrequired
homeTeamBaseballDetailedMatchRosterSinglerequired4 fields
jerseynumber
fullNamestringrequired
positionstringrequired
isStarterbooleanrequired
forecastDetailedMatchForecastResponse2 fields
statusstring
temperaturestring
predictionsPredictionResponse18 fields
prematchPrediction[]required8 fields
typestringrequired
modelTypestringrequired
generatedAtstringrequired
descriptionstringrequired
probabilitiesPredictionProbabilitiesrequired3 fields
homestringrequired
drawstring
awaystringrequired
livePrediction[]required8 fields
typestringrequired
modelTypestringrequired
generatedAtstringrequired
descriptionstringrequired
probabilitiesPredictionProbabilitiesrequired3 fields
homestringrequired
drawstring
awaystringrequired

Example response

200 application/json 
[
  {
    "id": 58348,
    "round": "regular-season",
    "date": "2024-03-31T17:00:00.000Z",
    "league": "NCAA",
    "season": 2024,
    "awayTeam": {
      "id": 219,
      "logo": "https://example.com/logos/team/219.png",
      "name": "Bears",
      "displayName": "Baylor",
      "abbreviation": "BAY"
    },
    "homeTeam": {
      "id": 219,
      "logo": "https://example.com/logos/team/219.png",
      "name": "Bears",
      "displayName": "Baylor",
      "abbreviation": "BAY"
    },
    "state": {
      "description": "Finished",
      "report": "Final",
      "score": {
        "home": {
          "hits": 4,
          "errors": 2,
          "innings": [
            0,
            0,
            1,
            1,
            0,
            0,
            1,
            1,
            1
          ]
        },
        "away": {
          "hits": 4,
          "errors": 2,
          "innings": [
            0,
            0,
            1,
            1,
            0,
            0,
            1,
            1,
            1
          ]
        },
        "current": "5 - 8"
      }
    },
    "venue": {
      "city": "Waco",
      "name": "Baylor Ballpark",
      "state": "Texas"
    },
    "stats": [
      {
        "team": {
          "id": 10291185,
          "name": "Toronto Blue Jays",
          "logo": "https://highlightly.net/baseball/images/teams/10291185.png",
          "statistics": [
            {
              "name": "Total Strikeouts",
              "value": 12,
              "group": "Batting"
            }
          ]
        }
      }
    ],
    "plays": [
      {
        "type": "Start Inning",
        "teamId": 229,
        "description": "Top of the 1st inning",
        "currentOuts": 0,
        "period": "Top 1st Inning",
        "runners": {
          "first": {
            "fullName": "Will Baker",
            "playerId": 1364867
          },
          "second": {
            "fullName": "Will Baker",
            "playerId": 1364867
          },
          "third": {
            "fullName": "Will Baker",
            "playerId": 1364867
          }
        },
        "pitcher": {
          "fullName": "Will Baker",
          "playerId": 1364867
        },
        "batter": {
          "fullName": "Will Baker",
          "playerId": 1364867
        },
        "pitch": {
          "type": "CURVE",
          "velocity": 78.2,
          "ballsCount": 0,
          "strikesCount": 0
        },
        "result": {
          "ballsCount": 1,
          "strikesCount": 2
        },
        "score": {
          "away": 1,
          "home": 2
        }
      }
    ],
    "referees": [
      {
        "name": "Jonathan  Parra",
        "position": "Home Plate Umpire"
      }
    ],
    "rosters": {
      "awayTeam": {
        "jersey": 1,
        "fullName": "Hunter Hines",
        "position": "First Baseman",
        "isStarter": true
      },
      "homeTeam": {
        "jersey": 1,
        "fullName": "Hunter Hines",
        "position": "First Baseman",
        "isStarter": true
      }
    },
    "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%"
          }
        }
      ]
    }
  }
]

Values are the examples declared in the OpenAPI spec, not a captured live response.

Errors

Status Description
400 Bad request descriptive error.
500 Internal server error.