--- title: "Get match by id" method: GET path: "/cricket/matches/{id}" tags: ["Cricket.Matches"] --- # Get match by id `GET /cricket/matches/{id}` ## Request - Base URL: `https://sports.highlightly.net` - URL: `https://sports.highlightly.net/cricket/matches/{id}` - Auth: none declared. Required headers: `x-rapidapi-host`, `x-rapidapi-key` - TypeScript: (a function with typed inputs; its response is checked against the schema) Retrieve detailed match information by specifying the match id path parameter. Fetched data will have additional information about the `venue` and weather `forecast`. > Note: Used to retrieve additional match information. ## Path parameters - `id` number, required ## Headers - `x-rapidapi-host` string, required - `x-rapidapi-key` string, required ## Response `200` - CricketDetailedMatchResponseDto[] - `id` string, required - `endDate` string, required - `startDate` string, required - `startTime` string - `country` CricketCountryResponseDto, required - `code` string, required: Country code specified by the ISO 3166 standard. - `name` string, required - `logo` string, required - `awayTeam` CricketTeamResponseDto, required - `id` string, required - `logo` string - `name` string, required - `abbreviation` string, required - `homeTeam` CricketTeamResponseDto, required - `id` string, required - `logo` string - `name` string, required - `abbreviation` string, required - `league` CricketMatchLeagueResponseDto, required - `id` string, required - `season` number, required - `name` string, required - `logo` string - `format` string: Cricket match format, e.g. T20, ODI, TEST - `dayType` 'SINGLE' | 'MULTI': Information that tells us whether the match will be played across multiple days - `state` CricketMatchStateResponseDto, required - `description` 'Finished' | 'Unknown' | 'No live coverage' | 'In play' | 'Stumps' | 'Lunch' | 'Innings break' | 'Drinks' | 'Timeout' | 'Tea' | 'Scheduled' | 'Match delayed' | 'Cancelled' | 'Abandoned' | 'Postponed', required: State of the match. - `report` string: Descriptive report of the match based on the match status. - `teams` CricketMatchScoreTeamsDto, required - `away` CricketMatchScoreTeamAwayDto, required - `info` string - `score` string - `home` CricketMatchScoreTeamHomeDto, required - `info` string - `score` string - `venue` DetailedMatchVenueResponseDto - `city` string - `name` string - `country` string - `capacity` string - `forecast` DetailedMatchForecastResponseDto - `status` string - `temperature` string - `statistics` CricketDetailedMatchStatisticsDataDto[] - `id` number, required: Cricket team id - `logo` string: Cricket team logo url - `name` number, required: Cricket team name - `abbreviation` string, required: Cricket team abbreviation - `inningNumber` number: Inning number - `fallOfWickets` FallOfWickets[] - `runs` number: Number of runs - `order` number: Current order number - `overs` number: Number of overs - `dismissalBatsman` DismissalBatsman - `name` string: Name of Dismissal Batsman - `inningBatsmen` InningBatsmen[] - `runs` number: Number of runs - `balls` number: Number of balls - `fours` number: Number of fours - `sixes` number: Number of sixes - `battingStrikeRate` number: Batting strike rate - `player` CricketBasePlayerStatsDataResponseDto - `name` string: Player name - `battingStyles` string[]: Players batting styles - `bowlingStyles` string[]: Players bowling styles - `roles` string[]: Players roles - `inningBowlers` InningBowlers[] - `overs` number: Number of overs - `player` CricketBasePlayerStatsDataResponseDto - `name` string: Player name - `battingStyles` string[]: Players batting styles - `bowlingStyles` string[]: Players bowling styles - `roles` string[]: Players roles - `economy` number: Economy statistics - `maidens` number: Number of maidens - `wickets` number: Number of wickets - `concededRuns` number: Number of conceded runs - `inningPartnerships` InningPartnerships[] - `runs` number: Number of runs - `balls` number: Number of balls - `overs` number: Number of overs - `firstPlayer` CricketBasePlayerStatsDataResponseDto - `name` string: Player name - `battingStyles` string[]: Players batting styles - `bowlingStyles` string[]: Players bowling styles - `roles` string[]: Players roles - `secondPlayer` CricketBasePlayerStatsDataResponseDto - `name` string: Player name - `battingStyles` string[]: Players batting styles - `bowlingStyles` string[]: Players bowling styles - `roles` string[]: Players roles - `firstPlayerRuns` number: Number of runs related to first player - `firstPlayerBalls` number: Number of balls related to fist player - `secondPlayerRuns` number: Number of runs related to second player - `secondPlayerBalls` number: Number of balls related to second player - `squad` CricketSquadResponseDto[] - `team` CricketBaseTeamDataResponseDto - `id` number, required: Cricket team id - `logo` string: Cricket team logo url - `name` number, required: Cricket team name - `abbreviation` string, required: Cricket team abbreviation - `players` CricketBasePlayerStatsDataResponseDto[] - `name` string: Player name - `battingStyles` string[]: Players batting styles - `bowlingStyles` string[]: Players bowling styles - `roles` string[]: Players roles - `bestBatsmen` CricketBestBatsmenResponseDto[] - `team` CricketBaseTeamDataResponseDto - `id` number, required: Cricket team id - `logo` string: Cricket team logo url - `name` number, required: Cricket team name - `abbreviation` string, required: Cricket team abbreviation - `players` CricketBestBatsmenStatisticsResponseDto[] - `name` string: Player name - `battingStyles` string[]: Players batting styles - `bowlingStyles` string[]: Players bowling styles - `roles` string[]: Players roles - `statistics` CricketBestBatsmenStatsResponseDto - `runs` number: Number of runs - `average` number: Batting average stats - `innings` number: Total number of innings - `matches` number: Total number of matches - `battingStrikeRate` number: Total batting strike rate - `bestBowlers` CricketBestBowlersResponseDto[] - `team` CricketBaseTeamDataResponseDto - `id` number, required: Cricket team id - `logo` string: Cricket team logo url - `name` number, required: Cricket team name - `abbreviation` string, required: Cricket team abbreviation - `players` CricketBestBowlerStatsResponseDto[] - `name` string: Player name - `battingStyles` string[]: Players batting styles - `bowlingStyles` string[]: Players bowling styles - `roles` string[]: Players roles - `statistics` CricketBestBowlerRawStatsDto - `balls` number: Number of balls - `average` number: Bowling average - `economy` number: Players economy rate - `innings` number: Number of innings - `matches` number: Number of matches - `wickets` number: Number of wickets - `concededRuns` number: Number of conceded runs - `battingStrikeRate` number: Batting strike rate - `predictions` PredictionResponseDto - `prematch` PredictionDto[], required - `type` string, required - `modelType` string, required - `generatedAt` string, required - `description` string, required - `probabilities` PredictionProbabilitiesDto, required - `home` string, required - `draw` string - `away` string, required - `live` PredictionDto[], required - `type` string, required - `modelType` string, required - `generatedAt` string, required - `description` string, required - `probabilities` PredictionProbabilitiesDto, required - `home` string, required - `draw` string - `away` string, required ## Other responses - `400`: Bad request descriptive error. - `500`: Internal server error. --- [API](https://skmtc.dev/highlightly/apis/sports-api-highlightly.md) - [All operations](https://skmtc.dev/highlightly/apis/sports-api-highlightly/llms.txt) - [OpenAPI document](https://skmtc.dev/highlightly/apis/sports-api-highlightly/revisions/c8a366d3091f?raw)