Get match by ID
GET
https://cricket.highlightly.net/matches/{id}
Cricket API
Retrieve detailed information for one match.
This is the detail view. Matches returns general information for a list of fixtures, and this route fills in everything that route leaves out.
Top performances are split by discipline, so bestBatsmen and
bestBowlers are separate lists, each grouped by team.
Players in this response are identified by name and carry no id. To read a
player's career record, find their id with the name filter on
players, then call
get player by ID.
Parameters
| Parameter | Type | Description |
|---|---|---|
idrequired
|
numberpath | Requested match id. |
Request
curl --request GET \
--url 'https://cricket.highlightly.net/matches/{id}' \
--header 'x-rapidapi-key: YOUR_API_KEY'const response = await fetch('https://cricket.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://cricket.highlightly.net/matches/{id}',
headers={
'x-rapidapi-key': os.environ['HIGHLIGHTLY_API_KEY'],
},
timeout=10,
)
response.raise_for_status()
data = response.json()Response
idstringrequired
endDatestringrequired
startDatestringrequired
startTimestring
countryCricketCountryResponserequired3 fields
codestringrequiredCountry code specified by the ISO 3166 standard.
namestringrequired
logostringrequired
awayTeamCricketTeamResponserequired4 fields
idstringrequired
logostring
namestringrequired
abbreviationstringrequired
homeTeamCricketTeamResponserequired4 fields
idstringrequired
logostring
namestringrequired
abbreviationstringrequired
leagueCricketMatchLeagueResponserequired4 fields
idstringrequired
seasonnumberrequired
namestringrequired
logostring
formatstringCricket match format, e.g. T20, ODI, TEST
dayTypestringInformation that tells us whether the match will be played across multiple
daysSINGLEMULTI
stateCricketMatchStateResponserequired9 fields
descriptionstringrequiredState of the match.FinishedUnknownNo live coverageIn playStumpsLunchInnings breakDrinksTimeoutTeaScheduledMatch delayedCancelledAbandonedPostponed
reportstringDescriptive report of the match based on the match status.
teamsCricketMatchScoreTeamsrequired6 fields
awayCricketMatchScoreTeamAwayrequired2 fields
infostring
scorestring
homeCricketMatchScoreTeamHomerequired2 fields
infostring
scorestring
venueDetailedMatchVenueResponse4 fields
citystring
namestring
countrystring
capacitystring
forecastDetailedMatchForecastResponse2 fields
statusstring
temperaturestring
statisticsCricketDetailedMatchStatisticsData[]69 fields
idnumberrequiredCricket team id
logostringCricket team logo url
namenumberrequiredCricket team name
abbreviationstringrequiredCricket team abbreviation
inningNumbernumberInning number
foursnumberTotal fours in the innings
sixesnumberTotal sixes in the innings
extrasnumberTotal extras in the innings
byesnumberByes conceded
legByesnumberLeg byes conceded
widesnumberWides bowled
noBallsnumberNo balls bowled
fieldingSummaryFieldingSummary5 fields
catchesnumberCatches taken by fielding team
catchesDroppednumberCatches dropped by fielding team
runsSavednumberRuns saved by fielding team
runOutsnumberRun outs effected
stumpingsnumberStumpings effected
fallOfWicketsFallOfWickets[]5 fields
runsnumberNumber of runs
ordernumberCurrent order number
oversnumberNumber of overs
dismissalBatsmanDismissalBatsman1 field
namestringName of Dismissal Batsman
inningBatsmenInningBatsmen[]15 fields
runsnumberNumber of runs
ballsnumberNumber of balls
foursnumberNumber of fours
sixesnumberNumber of sixes
battingStrikeRatenumberBatting strike rate
dismissalStatusstringDismissal status
dismissalFieldersDismissalFielder[]Fielders involved in the dismissal3 fields
namestringName of the fielder
isKeeperbooleanWhether the fielder is the wicketkeeper
isSubstitutebooleanWhether the fielder is a substitute
playerCricketBasePlayerStatsDataResponse4 fields
namestringPlayer name
battingStylesstring[]Players batting styles
bowlingStylesstring[]Players bowling styles
rolesstring[]Players roles
inningBowlersInningBowlers[]10 fields
oversnumberNumber of overs
playerCricketBasePlayerStatsDataResponse4 fields
namestringPlayer name
battingStylesstring[]Players batting styles
bowlingStylesstring[]Players bowling styles
rolesstring[]Players roles
economynumberEconomy statistics
maidensnumberNumber of maidens
wicketsnumberNumber of wickets
concededRunsnumberNumber of conceded runs
inningPartnershipsInningPartnerships[]17 fields
runsnumberNumber of runs
ballsnumberNumber of balls
oversnumberNumber of overs
firstPlayerCricketBasePlayerStatsDataResponse4 fields
namestringPlayer name
battingStylesstring[]Players batting styles
bowlingStylesstring[]Players bowling styles
rolesstring[]Players roles
secondPlayerCricketBasePlayerStatsDataResponse4 fields
namestringPlayer name
battingStylesstring[]Players batting styles
bowlingStylesstring[]Players bowling styles
rolesstring[]Players roles
firstPlayerRunsnumberNumber of runs related to first player
firstPlayerBallsnumberNumber of balls related to fist player
secondPlayerRunsnumberNumber of runs related to second player
secondPlayerBallsnumberNumber of balls related to second player
squadCricketSquadResponse[]10 fields
teamCricketBaseTeamDataResponse4 fields
idnumberrequiredCricket team id
logostringCricket team logo url
namenumberrequiredCricket team name
abbreviationstringrequiredCricket team abbreviation
playersCricketBasePlayerStatsDataResponse[]4 fields
namestringPlayer name
battingStylesstring[]Players batting styles
bowlingStylesstring[]Players bowling styles
rolesstring[]Players roles
bestBatsmenCricketBestBatsmenResponse[]16 fields
teamCricketBaseTeamDataResponse4 fields
idnumberrequiredCricket team id
logostringCricket team logo url
namenumberrequiredCricket team name
abbreviationstringrequiredCricket team abbreviation
playersCricketBestBatsmenStatisticsResponse[]10 fields
namestringPlayer name
battingStylesstring[]Players batting styles
bowlingStylesstring[]Players bowling styles
rolesstring[]Players roles
statisticsCricketBestBatsmenStatsResponse5 fields
runsnumberNumber of runs
averagenumberBatting average stats
inningsnumberTotal number of innings
matchesnumberTotal number of matches
battingStrikeRatenumberTotal batting strike rate
bestBowlersCricketBestBowlersResponse[]19 fields
teamCricketBaseTeamDataResponse4 fields
idnumberrequiredCricket team id
logostringCricket team logo url
namenumberrequiredCricket team name
abbreviationstringrequiredCricket team abbreviation
playersCricketBestBowlerStatsResponse[]13 fields
namestringPlayer name
battingStylesstring[]Players batting styles
bowlingStylesstring[]Players bowling styles
rolesstring[]Players roles
statisticsCricketBestBowlerRawStats8 fields
ballsnumberNumber of balls
averagenumberBowling average
economynumberPlayers economy rate
inningsnumberNumber of innings
matchesnumberNumber of matches
wicketsnumberNumber of wickets
concededRunsnumberNumber of conceded runs
battingStrikeRatenumberBatting strike rate
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
inplayDataCricketInplayResponse35 fields
bowlersBolwerData[]required16 fields
teamTeamInforequired4 fields
idstringrequired
logostring
namestringrequired
abbreviationstring
playerBowlerPlayerLivePerformanceInforequired10 fields
namestringrequired
battingStylesstring[]required
bowlingStylesstring[]required
rolesstring[]required
statisticsBowlerStatsrequired5 fields
oversnumber
ballsnumber
runsConcedednumber
wicketsnumber
economynumber
batsmenBatsmenData[]required17 fields
teamTeamInforequired4 fields
idstringrequired
logostring
namestringrequired
abbreviationstring
playerBatsmenPlayerLivePerformanceInfo11 fields
namestringrequired
battingStylesstring[]required
bowlingStylesstring[]required
rolesstring[]required
inningnumberrequired
statisticsBastmenStatsrequired5 fields
runsnumber
ballsnumber
foursnumber
sixesnumber
strikeRatenumber
Example response
200 application/json
[
{
"id": "49877382",
"endDate": "2024-03-31T00:00:00.000Z",
"startDate": "2024-03-31T00:00:00.000Z",
"startTime": "2024-03-31T06:00:00.000Z",
"country": {
"code": "AU",
"name": "Australia",
"logo": "https://example.com/logos/country/AU.png"
},
"awayTeam": {
"id": "17838627",
"logo": "https://example.com/logos/team/17838627.png",
"name": "Melbourne Stars",
"abbreviation": "MS"
},
"homeTeam": {
"id": "17838627",
"logo": "https://example.com/logos/team/17838627.png",
"name": "Melbourne Stars",
"abbreviation": "MS"
},
"league": {
"id": "48513362",
"season": 2023,
"name": "Big Bash League",
"logo": "https://example.com/logos/league/48513362.png"
},
"format": "T20",
"dayType": "SINGLE",
"state": {
"description": "Finished",
"report": "Renegades won by 6 wickets (with 16 balls remaining)",
"teams": {
"away": {
"info": "17.2/20 ov, T:138",
"score": "139/4"
},
"home": {
"info": null,
"score": "137/8"
}
}
},
"venue": {
"city": "Swansea",
"name": "Liberty Stadium",
"country": "Wales",
"capacity": "20827"
},
"forecast": {
"status": "cloudy",
"temperature": "11.97°C"
},
"statistics": [
{
"id": 282,
"logo": "https://highlightly.net/cricket/images/teams/282.png",
"name": "West Indies",
"abbreviation": "WI",
"inningNumber": 1,
"fours": 15,
"sixes": 9,
"extras": 12,
"byes": 2,
"legByes": 4,
"wides": 5,
"noBalls": 1,
"fieldingSummary": {
"catches": 6,
"catchesDropped": 2,
"runsSaved": 3,
"runOuts": 1,
"stumpings": 0
},
"fallOfWickets": [
{
"runs": 5,
"order": 1,
"overs": 1.2,
"dismissalBatsman": {
"name": "Ryan Rickelton"
}
}
],
"inningBatsmen": [
{
"runs": 4,
"balls": 5,
"fours": 0,
"sixes": 0,
"battingStrikeRate": 90,
"dismissalStatus": "caught",
"dismissalFielders": [
{
"name": "Jos Buttler",
"isKeeper": true,
"isSubstitute": false
}
],
"player": {
"name": "Ryan Rickelton",
"battingStyles": [
""
],
"bowlingStyles": [
""
],
"roles": [
""
]
}
}
],
"inningBowlers": [
{
"overs": 4,
"player": {
"name": "Ryan Rickelton",
"battingStyles": [
""
],
"bowlingStyles": [
""
],
"roles": [
""
]
},
"economy": 5.5,
"maidens": 0,
"wickets": 1,
"concededRuns": 2
}
],
"inningPartnerships": [
{
"runs": 5,
"balls": 8,
"overs": 1.2,
"firstPlayer": {
"name": "Ryan Rickelton",
"battingStyles": [
""
],
"bowlingStyles": [
""
],
"roles": [
""
]
},
"secondPlayer": {
"name": "Ryan Rickelton",
"battingStyles": [
""
],
"bowlingStyles": [
""
],
"roles": [
""
]
},
"firstPlayerRuns": 1,
"firstPlayerBalls": 3,
"secondPlayerRuns": 3,
"secondPlayerBalls": 5
}
]
}
],
"squad": [
{
"team": {
"id": 282,
"logo": "https://highlightly.net/cricket/images/teams/282.png",
"name": "West Indies",
"abbreviation": "WI"
},
"players": [
{
"name": "Ryan Rickelton",
"battingStyles": [
""
],
"bowlingStyles": [
""
],
"roles": [
""
]
}
]
}
],
"bestBatsmen": [
{
"team": {
"id": 282,
"logo": "https://highlightly.net/cricket/images/teams/282.png",
"name": "West Indies",
"abbreviation": "WI"
},
"players": [
{
"name": "Ryan Rickelton",
"battingStyles": [
""
],
"bowlingStyles": [
""
],
"roles": [
""
],
"statistics": {
"runs": 220,
"average": 36.6667,
"innings": 9,
"matches": 10,
"battingStrikeRate": 126.43
}
}
]
}
],
"bestBowlers": [
{
"team": {
"id": 282,
"logo": "https://highlightly.net/cricket/images/teams/282.png",
"name": "West Indies",
"abbreviation": "WI"
},
"players": [
{
"name": "Ryan Rickelton",
"battingStyles": [
""
],
"bowlingStyles": [
""
],
"roles": [
""
],
"statistics": {
"balls": 126,
"average": 21.29,
"economy": 7.1,
"innings": 6,
"matches": 6,
"wickets": 7,
"concededRuns": 149,
"battingStrikeRate": 18
}
}
]
}
],
"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%"
}
}
]
},
"inplayData": {
"bowlers": [
{
"team": {
"id": "11759092",
"logo": "https://highlightly.net/cricket/images/teams/11759092.png",
"name": "Royal Challengers Bangalore",
"abbreviation": "RCB"
},
"player": {
"name": "Rasikh Salam",
"battingStyles": [
"rhb"
],
"bowlingStyles": [
"rm"
],
"roles": [
"bowler"
],
"statistics": {
"overs": 2.1,
"balls": 13,
"runsConceded": 21,
"wickets": 0,
"economy": 9.69
}
}
}
],
"batsmen": [
{
"team": {
"id": "11759092",
"logo": "https://highlightly.net/cricket/images/teams/11759092.png",
"name": "Royal Challengers Bangalore",
"abbreviation": "RCB"
},
"player": {
"name": "Sherfane Rutherford",
"battingStyles": [
"lhb"
],
"bowlingStyles": [
"rfm"
],
"roles": [
"middle-order batter"
],
"inning": 2,
"statistics": {
"runs": 17,
"balls": 8,
"fours": 0,
"sixes": 6,
"strikeRate": 212.5
}
}
}
]
}
}
]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. |
