{"openapi":"3.0.0","paths":{"/highlights":{"get":{"description":"> Refresh interval: Once a minute\n\n> Note: Certain highlights might be uploaded whilst the game is playing. Full game recaps tend to be uploaded anywhere from 1 to 48 hours after a match is finished.\n\n  Highlights represent the core of our API. They include various different kinds of clips ranging from real time live events such as insane plays, last minute scores to full game recaps, pre/post match interviews. \n\nCurrently we aggregate videos from many different sources. Depending on the source and verification process we divide the clips into two categories:\n\n| Type        | Description |\n| ----------- | ----------- |\n| VERIFIED    | Videos come from reputable sources that have been thoroughly inspected. In most cases the clips are from official authors who own the copyrights to the video itself. The hosting platform can impose geo restrictions or prevent direct embedding (`highlights/geo-restrictions/{highlightId}` route can be used to check for potential restrictions). Verified highlights are uploaded anywhere from 1 to 48 hours of the match being finished. |\n| UNVERIFIED  | Highlights vary and might not have gone through the verification process or are considered user uploaded. Videos include a wide spectrum of topics such as last minute scores, memorable plays, game recaps, etc. Unverified highlights are considered more real time and might be uploaded even when the match is still being played. The lifetime of these clips vary and is dependant on the hosting platform.       |\n\nEach highlight has a `title` which describes what the video is about. Certain entries will have a `description` as well which is used to further describe the associated clip. The `source` field defines where the clip was aggregated from (e.g. would be *youtube*, *twitter*, *reddit*, *espn*, etc.). For certain sources you will see additional information being present in the `channel` field. By utilising this information you can further narrow down which videos you want to showcase. Highlights might also have an `embedUrl` property which is used to directly embed the videos into your website or mobile application.\n\nEach highlight also has a `category` field which describes the type of content the clip contains. Categorization happens automatically when a highlight is aggregated. Clips that cannot be confidently placed are labeled `other` rather than being forced into a category they do not belong to, so filtering by a specific category will not return unrelated content.\n\n### Categories\n\nEach highlight has a `category` field describing the clip's content type. Possible values for this sport:\n\n| Category | Description |\n| -------- | ----------- |\n| `match-highlights` | Edited recap of a match (full-game highlights, summaries in any language). |\n| `home-run` | Home run. |\n| `grand-slam` | Grand slam. |\n| `walk-off` | Walk-off game-winner. |\n| `hit-rbi` | Hits and RBI plays. |\n| `pitching-highlight` | Strikeouts, gems and other pitching performances. |\n| `defensive-highlight` | Diving catches, double plays, robbed home runs. |\n| `stolen-base` | Stolen bases and baserunning plays. |\n| `save-closer` | Closer shutting the game down. |\n| `error-miscue` | Errors, misplays and miscues. |\n| `injury` | A player injured on the play (carted/helped off, exits the game). |\n| `viral-moment` | Celebrations, mascots, milestones, tributes and other spectacle moments. |\n| `pre-match-content` | Previews, predictions and build-up content ahead of a match. |\n| `post-match-content` | Reactions, interviews and analysis after a match. |\n| `spring-training` | Spring-training content. |\n| `other` | Clips that do not fit any other category. |\n\nBelow is an example of what you can aim to achieve with our highlights data:\n\n![Highlights example](https://highlightly.net/assets/img/documentation/baseball/highlights.png)\n\n\n## Retrieve highlights\n\nRetrieve a list of highlights based on the requested query parameters.\n\nAt least one primary query parameter needs to be specified before you can retrieve the data (`timezone`, `limit`, `offset` are considered secondary).\n\nYou can specify the `timezone` field in combination with the `date` query parameter to get highlights relevant to your location.\n\nThere are two other important parameters. The `limit` parameter defines what the number of returned highlights will be. If the number of actual highlights is above the `limit` value you can make subsequent requests by increasing the `offset` value. \n\n> Note: The Basic/Free plan might have certain restrictions in place. More information can be found [here](https://rapidapi.com/highlightly-api-highlightly-api-default/api/mlb-college-baseball-api).\n","operationId":"HighlightsController_getHighlights","parameters":[{"name":"x-rapidapi-host","in":"header","description":"mlb-college-baseball-api.p.rapidapi.com","required":true,"schema":{"type":"string"}},{"name":"x-rapidapi-key","in":"header","description":"Rapid API Token","required":true,"schema":{"type":"string"}},{"required":false,"name":"leagueName","in":"query","schema":{"example":"NCAA","type":"string"}},{"description":"Date that follows the YYYY-MM-DD format.","required":false,"name":"date","in":"query","schema":{"example":"2022-06-10","type":"string"}},{"description":"Valid timezone identifier.","required":false,"name":"timezone","in":"query","schema":{"default":"Etc/UTC","example":"Europe/London","type":"string"}},{"required":false,"name":"season","in":"query","schema":{"example":2022,"type":"number"}},{"required":false,"name":"matchId","in":"query","schema":{"example":343056,"type":"number"}},{"required":false,"name":"homeTeamId","in":"query","schema":{"example":10291525,"type":"number"}},{"required":false,"name":"awayTeamId","in":"query","schema":{"example":10291566,"type":"number"}},{"required":false,"name":"homeTeamName","in":"query","schema":{"example":"Pirates","type":"string"}},{"required":false,"name":"awayTeamName","in":"query","schema":{"example":"Longhorns","type":"string"}},{"required":false,"name":"homeTeamAbbreviation","in":"query","schema":{"example":"ECU","type":"string"}},{"required":false,"name":"awayTeamAbbreviation","in":"query","schema":{"example":"TEX","type":"string"}},{"required":false,"name":"homeTeamDisplayName","in":"query","schema":{"example":"East Carolina","type":"string"}},{"required":false,"name":"awayTeamDisplayName","in":"query","schema":{"example":"Texas","type":"string"}},{"required":false,"name":"limit","in":"query","schema":{"minimum":0,"maximum":40,"default":40,"example":40,"type":"number"}},{"required":false,"name":"offset","in":"query","schema":{"minimum":0,"default":0,"example":0,"type":"number"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseballHighlightPaginatedResponseDto"}}}},"400":{"description":"Bad request descriptive error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestDto"}}}},"500":{"description":"Internal server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorDto"}}}}},"summary":"Get all highlights","tags":["Baseball.Highlights"]}},"/highlights/geo-restrictions/{id}":{"get":{"description":"> Refresh interval: Once an hour\n\n> Note: Endpoint is not available in the Basic/Free plan.\n\nGeo restrictions are a plague that have been around for quite a while. They restrict access to online content based on the viewers geographical location. Trying to show restricted highlights to your users can greatly hinder the viewing experience.\n\nEach highlight has a `state` property which defines how the geo restrictions are applied.\n\n| State       | Description   |\n| ----------- | -----------   |\n| No restricitons applied                 | Highlight has no restrictions applied and is available globally.            |   \n| Allowed countries restriction           | Highlight is only available to users whose country code is found in the `allowedCountries` list.             |\n| Blocked countries restriction           | Highlight is blocked to all users whose country code is found in the `blockedCountries` list.               |\n| Unknown restrictions                    | There is no guaranteed way to define all allowed or blocked countries.            |\n\nAs presented before, certain highlights have an `embedUrl` field which can be used to directly embed the video into your website or application. The `embeddable` field specifies whether this is allowed or not. \n","operationId":"HighlightsController_getGeoRestrictions","parameters":[{"name":"x-rapidapi-host","in":"header","description":"mlb-college-baseball-api.p.rapidapi.com","required":true,"schema":{"type":"string"}},{"name":"x-rapidapi-key","in":"header","description":"Rapid API Token","required":true,"schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Requested highlight id.","schema":{"type":"number"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RestrictionResponseDto"}}}},"400":{"description":"Bad request descriptive error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestDto"}}}},"500":{"description":"Internal server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorDto"}}}}},"summary":"Get geo restrictions for highlight","tags":["Baseball.Highlights"]}},"/highlights/{id}":{"get":{"description":"\nRetrieve highlight information by specifying the highlight id path parameter.\n\n> Note: Used to check whether a highlight still exists or had its information updated.\n","operationId":"HighlightsController_getHighlightById","parameters":[{"name":"x-rapidapi-host","in":"header","description":"mlb-college-baseball-api.p.rapidapi.com","required":true,"schema":{"type":"string"}},{"name":"x-rapidapi-key","in":"header","description":"Rapid API Token","required":true,"schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Requested highlight id.","schema":{"type":"number"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/BaseballHighlightResponseDto"}}}}},"400":{"description":"Bad request descriptive error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestDto"}}}},"500":{"description":"Internal server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorDto"}}}}},"summary":"Get highlight by id","tags":["Baseball.Highlights"]}},"/matches":{"get":{"description":"> Refresh interval: Once a minute\n\n> Route returns only general match information. For additional match details check the `matches/{matchId}` route. \n\nRetrieve a list of matches based on the requested query parameters. \n\nAt least one primary query parameter needs to be specified before you can retrieve the data (`timezone`, `limit`, `offset` are considered secondary).\n\nYou can specify the `timezone` field in combination with the `date` query parameter to get matches relevant to your location.\n\nThere are two other important parameters. The `limit` parameter defines what the number of returned matches will be. If the number of actual matches is above the `limit` value you can make subsequent requests by increasing the `offset` value. \n\nMatches have different possible states they can be in:\n\n| State        | Description |\n| -----------  | ----------- |\n| Finished  | Match has been concluded.          |\n| Postponed  | Match has been postponed due to certain circumstances that are preventing the game from being played. Event start time will be changed to a moment in the future.           |\n| Scheduled    |  Match has not been started yet.         |\n| Canceled  |  Game will not be played.         |\n| Abandoned  | Considered \"abandoned\" when it is prematurely ended by the officials and can not be resumed or completed. In the future the game **might be** resumed from the exact point where it was halted.            |\n| In Progress  | Game is currently in progress.         |\n| Half Time  | Half time pause between first and second half.          |\n| Suspended  |  Match has already been in play but was suspended. In the future the game will resume from the exact point where it was halted.         |\n| Unknown  | Unknown match coverage or state.          |\n| Rain Delay  | Match has been delayed due to bad weather conditions. Will either be resumed or suspended.         |\n| Period End  |  Break time between periods.         |\n\nBelow is an example of what you can aim to achieve with the matches endpoint:\n\n![Baseball matches example](https://highlightly.net/assets/img/documentation/baseball/matches.png)","operationId":"BaseballMatchController_getMatches","parameters":[{"name":"x-rapidapi-host","in":"header","description":"mlb-college-baseball-api.p.rapidapi.com","required":true,"schema":{"type":"string"}},{"name":"x-rapidapi-key","in":"header","description":"Rapid API Token","required":true,"schema":{"type":"string"}},{"required":false,"name":"league","in":"query","schema":{"example":"MLB","type":"string"}},{"description":"Date that follows the YYYY-MM-DD format.","required":false,"name":"date","in":"query","schema":{"example":"2024-08-31","type":"string"}},{"description":"Valid timezone identifier.","required":false,"name":"timezone","in":"query","schema":{"default":"Etc/UTC","example":"Europe/London","type":"string"}},{"required":false,"name":"season","in":"query","schema":{"example":2024,"type":"number"}},{"required":false,"name":"homeTeamId","in":"query","schema":{"example":10291199,"type":"number"}},{"required":false,"name":"awayTeamId","in":"query","schema":{"example":10291203,"type":"number"}},{"required":false,"name":"homeTeamName","in":"query","schema":{"example":"Rangers","type":"string"}},{"required":false,"name":"awayTeamName","in":"query","schema":{"example":"Athletics","type":"string"}},{"required":false,"name":"homeTeamAbbreviation","in":"query","schema":{"example":"TEX","type":"string"}},{"required":false,"name":"awayTeamAbbreviation","in":"query","schema":{"example":"OAK","type":"string"}},{"required":false,"name":"homeTeamDisplayName","in":"query","schema":{"example":"Texas Rangers","type":"string"}},{"required":false,"name":"awayTeamDisplayName","in":"query","schema":{"example":"Oakland Athletics","type":"string"}},{"required":false,"name":"limit","in":"query","schema":{"minimum":0,"maximum":100,"default":100,"example":100,"type":"number"}},{"required":false,"name":"offset","in":"query","schema":{"minimum":0,"default":0,"example":0,"type":"number"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseballMatchPaginatedResponseDto"}}}},"400":{"description":"Bad request descriptive error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestDto"}}}},"500":{"description":"Internal server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorDto"}}}}},"summary":"Get all matches","tags":["Baseball.Matches"]}},"/matches/{id}":{"get":{"description":"\nRetrieve detailed match information by specifying the match id path parameter.\n\nFetched data will have additional information about the `venue`, weather `forecast`, match `stats`, who the game's `referees` are, each team's `rosters`, and `plays`.\n\n> Note: Used to retrieve additional match information.\n","operationId":"BaseballMatchController_getMatchById","parameters":[{"name":"x-rapidapi-host","in":"header","description":"mlb-college-baseball-api.p.rapidapi.com","required":true,"schema":{"type":"string"}},{"name":"x-rapidapi-key","in":"header","description":"Rapid API Token","required":true,"schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Requested match id.","schema":{"type":"number"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/BaseballDetailedMatchResponseDto"}}}}},"400":{"description":"Bad request descriptive error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestDto"}}}},"500":{"description":"Internal server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorDto"}}}}},"summary":"Get match by id","tags":["Baseball.Matches"]}},"/teams":{"get":{"description":"Retrieve a list of teams that are supported by the API.\n\nBy utilising either `league`, `name`, `displayName` or `abbreviation` query parameters you can check whether a specific team exists or simply retrieve the associated data.\n","operationId":"TeamController_getTeams","parameters":[{"name":"x-rapidapi-host","in":"header","description":"mlb-college-baseball-api.p.rapidapi.com","required":true,"schema":{"type":"string"}},{"name":"x-rapidapi-key","in":"header","description":"Rapid API Token","required":true,"schema":{"type":"string"}},{"required":false,"name":"league","in":"query","schema":{"example":"MLB","type":"string"}},{"required":false,"name":"name","in":"query","schema":{"example":"Rangers","type":"string"}},{"required":false,"name":"displayName","in":"query","schema":{"example":"Texas Rangers","type":"string"}},{"required":false,"name":"abbreviation","in":"query","schema":{"example":"TEX","type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/BaseballTeamResponseDto"}}}}},"400":{"description":"Bad request descriptive error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestDto"}}}},"500":{"description":"Internal server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorDto"}}}}},"summary":"Get all teams","tags":["Baseball.Teams"]}},"/teams/statistics/{id}":{"get":{"description":"\n> Refresh interval: Immediately once a match is finished.\n \nRetrieve team stats for each league and season by specifying the team's `id` path parameter. Requires `fromDate` query parameter to be specified in the YYYY-MM-DD format. Additionally, the `timezone` query parameter can be specified to futher narrow down the search results based on your location.\n","operationId":"TeamController_getTeamStats","parameters":[{"name":"x-rapidapi-host","in":"header","description":"mlb-college-baseball-api.p.rapidapi.com","required":true,"schema":{"type":"string"}},{"name":"x-rapidapi-key","in":"header","description":"Rapid API Token","required":true,"schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Requested team id.","schema":{"type":"number"}},{"description":"Date that follows the YYYY-MM-DD format.","name":"fromDate","in":"query","required":true,"schema":{"example":"2023-08-06","type":"string"}},{"description":"Valid timezone identifier.","required":false,"name":"timezone","in":"query","schema":{"default":"Etc/UTC","example":"Europe/London","type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/BaseballTeamStatisticsResponseDto"}}}}},"400":{"description":"Bad request descriptive error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestDto"}}}},"500":{"description":"Internal server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorDto"}}}}},"summary":"Get team statistics","tags":["Baseball.Teams"]}},"/teams/{id}":{"get":{"description":"Retrieve team information by specifying the team id path parameter.\n\n> Note: Used to check whether a team still exists or had its information updated.","operationId":"TeamController_getTeamById","parameters":[{"name":"x-rapidapi-host","in":"header","description":"mlb-college-baseball-api.p.rapidapi.com","required":true,"schema":{"type":"string"}},{"name":"x-rapidapi-key","in":"header","description":"Rapid API Token","required":true,"schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Requested team id.","schema":{"type":"number"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/BaseballTeamResponseDto"}}}}},"400":{"description":"Bad request descriptive error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestDto"}}}},"500":{"description":"Internal server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorDto"}}}}},"summary":"Get team by team id","tags":["Baseball.Teams"]}},"/standings":{"get":{"description":"> Refresh interval: Up to an hour after a match for the associated league and season is finished\n  \n  Retrieve standings data for a specific league, conference or division.\n  \n  There are numerous ways on how to fetch the data. You can utilise either `abbreviation` or `leagueName`:\n\n  | League Name | Abbreviation  |\n  | ----------- | ----------- |\n  | American League (MLB)\t| AL |\n  | National League (MLB)\t| NL |\n  | NCAA Division I (CBASE)\t| NCAA |\n\nAdditionally you can specify the `year` parameter to narrow down the the standings for that season.\n\nThere are two other important parameters that are used to navigate through the pagination. The `limit` parameter defines what the number of returned standings will be. If the number of actual standings is above the `limit` value you can make subsequent requests by increasing the `offset` value. \n\nBelow is an example on how you could render league associated standings\n  \n![Standings example](https://highlightly.net/assets/img/documentation/nhl/standings.png)","operationId":"BaseballStandingsController_getStandings","parameters":[{"name":"x-rapidapi-host","in":"header","description":"mlb-college-baseball-api.p.rapidapi.com","required":true,"schema":{"type":"string"}},{"name":"x-rapidapi-key","in":"header","description":"Rapid API Token","required":true,"schema":{"type":"string"}},{"required":false,"name":"leagueType","in":"query","schema":{"example":"MLB","type":"string"}},{"required":false,"name":"limit","in":"query","schema":{"minimum":0,"maximum":10,"default":10,"example":5,"type":"number"}},{"required":false,"name":"offset","in":"query","schema":{"minimum":0,"default":0,"example":0,"type":"number"}},{"required":false,"name":"leagueName","in":"query","schema":{"example":"National League (MLB)","type":"string"}},{"required":false,"name":"abbreviation","in":"query","schema":{"example":"NL","type":"string"}},{"required":false,"name":"year","in":"query","schema":{"example":2024,"type":"number"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseballStandingsPaginatedResponseDto"}}}},"400":{"description":"Bad request descriptive error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestDto"}}}},"500":{"description":"Internal server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorDto"}}}}},"summary":"Get standings","tags":["Baseball.Standings"]}},"/odds":{"get":{"description":"\n> Prematch odds refresh interval: Multiple times a day\n \n> Live odds refresh interval: Once every 10 minutes\n \n> Note: Endpoint is not available in the Basic/Free plan.\n\nRetrieve a list of match odds based on the requested query parameters. With `oddsType` query parameter you can specify whether you want **prematch** or **live** odds. If you do not set a specific value **prematch** odds will be returned.\n\nAt least one primary query parameter needs to be specified before you can retrieve the data (`timezone`, `limit`, `offset`, `oddsType` are considered secondary).\n\nThe most popular way of getting match odds is by specifying the `matchId` query parameter. You can also utilise the `date` parameter alongside the `timezone` to fetch all match odds for a given day. By specifying league or bookmaker related fields you can further narrow down your search.\n\nAs it stands, we currently offer the support for the following markets:\n\n| Market | Description |\n| ----------- | ----------- |\n| Home/Away | The possible outcomes for the mentioned market are either `Home` or `Away`. There is no possible way for the game to end in a `Draw`. |\n| Over/Under | This is considered a complex market. It is split into multiple possible variants such as *\"Over/Under 7.5\"*, *\"Over/Under 9.5\"* points and so on. The possible outcome of a variant is either `Over` or `Under`.|\n| Asian Handicap | This is considered a complex market. It is split into multiple possible variants such as *\"Asian Handicap -0.5/+0.5\"*, *\"Asian Handicap -1.5/+1.5\"* and so on. The possible outcome of a variant is either `Home` or `Away`.|\n| Odd or Even| The Odd or Even market defines whether the score of both teams will be either `Odd` or `Even`. |\n\nThere are two other important query parameters. The `limit` parameter defines what the number of returned match odds will be. If the number of actual match odds is above the `limit` value you can make subsequent requests by increasing the `offset` value.\n\n> Match odds are available up to 28 days after the game finishes and up to 7 days before the game starts.\n\nBelow is an example of what can be achieved with bookmaker odds on a match basis:\n\n![Odds example](https://highlightly.net/assets/img/documentation/odds-ha.png)","operationId":"BaseballOddsController_getOddsV2","parameters":[{"name":"x-rapidapi-host","in":"header","description":"mlb-college-baseball-api.p.rapidapi.com","required":true,"schema":{"type":"string"}},{"name":"x-rapidapi-key","in":"header","description":"Rapid API Token","required":true,"schema":{"type":"string"}},{"description":"Defines whether live or prematch odds will be returned.","required":false,"name":"oddsType","in":"query","schema":{"example":"prematch","type":"string"}},{"required":false,"name":"leagueName","in":"query","schema":{"example":"MLB","type":"string"}},{"description":"Valid timezone identifier.","required":false,"name":"timezone","in":"query","schema":{"default":"Etc/UTC","example":"Europe/London","type":"string"}},{"required":false,"name":"bookmakerId","in":"query","schema":{"example":7122,"type":"number"}},{"required":false,"name":"limit","in":"query","schema":{"minimum":0,"maximum":5,"default":5,"example":5,"type":"number"}},{"required":false,"name":"offset","in":"query","schema":{"minimum":0,"default":0,"example":0,"type":"number"}},{"required":false,"name":"matchId","in":"query","schema":{"type":"number"}},{"required":false,"name":"bookmakerName","in":"query","schema":{"example":"Stake.com","type":"string"}},{"description":"Date that follows the YYYY-MM-DD format.","required":false,"name":"date","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseballOddsPaginatedResponseDto"}}}},"400":{"description":"Bad request descriptive error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestDto"}}}},"500":{"description":"Internal server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorDto"}}}}},"summary":"Get all odds","tags":["Baseball.Odds"]}},"/bookmakers":{"get":{"description":"> Refresh interval: Once a day\n\nRetrieve a list of supported bookmakers. \n\nThere are two important parameters that are used to navigate through the pagination. The `limit` parameter defines what the number of returned bookmakers will be. If the number of actual bookmakers is above the `limit` value you can make subsequent requests by increasing the `offset` value. \n\nThe bookmakers `name` or `id` can be used to filter data from the `odds` endpoint. ","operationId":"BaseballBookmakersController_getBookmakers","parameters":[{"name":"x-rapidapi-host","in":"header","description":"mlb-college-baseball-api.p.rapidapi.com","required":true,"schema":{"type":"string"}},{"name":"x-rapidapi-key","in":"header","description":"Rapid API Token","required":true,"schema":{"type":"string"}},{"required":false,"name":"name","in":"query","schema":{"example":"Megapari Sport","type":"string"}},{"required":false,"name":"limit","in":"query","schema":{"minimum":0,"maximum":100,"default":20,"example":20,"type":"number"}},{"required":false,"name":"offset","in":"query","schema":{"minimum":0,"default":0,"example":0,"type":"number"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseballBookmakersPaginatedResponseDto"}}}},"400":{"description":"Bad request descriptive error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestDto"}}}},"500":{"description":"Internal server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorDto"}}}}},"summary":"Get all bookmakers","tags":["Baseball.Bookmakers"]}},"/bookmakers/{id}":{"get":{"description":"\nRetrieve bookmaker information by specifying the bookmaker id path parameter.\n\n> Note: Used to check whether a bookmaker still exists or had its information updated.\n","operationId":"BaseballBookmakersController_getBookmakerById","parameters":[{"name":"x-rapidapi-host","in":"header","description":"mlb-college-baseball-api.p.rapidapi.com","required":true,"schema":{"type":"string"}},{"name":"x-rapidapi-key","in":"header","description":"Rapid API Token","required":true,"schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Requested bookmaker id.","schema":{"type":"number"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/BaseballBookmakerResponseDto"}}}}},"400":{"description":"Bad request descriptive error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestDto"}}}},"500":{"description":"Internal server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorDto"}}}}},"summary":"Get bookmaker by id","tags":["Baseball.Bookmakers"]}},"/last-five-games":{"get":{"description":"> Refresh interval: Immediately once a game is considered finished\n\nRetrieve a list of the **last five finished** games for a specific team. If a game was not finished (e.g. was cancelled or postponed) it will *not* be returned.\n\nSpecify `teamId` query parameter to retrieve the data. Endpoint is used to create a form section between two teams that are playing a match. Below is an example of what can be achieved:\n\n![Last five games example](https://highlightly.net/assets/img/documentation/l5g-baseball.png)","operationId":"BaseballLastFiveGamesController_getLastFiveGames","parameters":[{"name":"x-rapidapi-host","in":"header","description":"mlb-college-baseball-api.p.rapidapi.com","required":true,"schema":{"type":"string"}},{"name":"x-rapidapi-key","in":"header","description":"Rapid API Token","required":true,"schema":{"type":"string"}},{"name":"teamId","in":"query","required":true,"schema":{"example":10291525,"type":"number"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/BaseballMatchResponseDto"}}}}},"400":{"description":"Bad request descriptive error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestDto"}}}},"500":{"description":"Internal server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorDto"}}}}},"summary":"Get last five finished games for a specific team id","tags":["Baseball.Last Five Games"]}},"/head-2-head":{"get":{"description":"Retrieve a list of the **last ten** head 2 head games between two teams. Compare the two teams to find out who is stronger based on their past match results. \n\nSpecify `teamIdOne` and `teamIdTwo` query parameters to retrieve the data. The order of team ids does not matter.\n\nBelow is an example of what you can achieve with the data:\n\n![H2H example](https://highlightly.net/assets/img/documentation/baseball/h2h.png)","operationId":"BaseballHead2HeadController_getHead2HeadData","parameters":[{"name":"x-rapidapi-host","in":"header","description":"mlb-college-baseball-api.p.rapidapi.com","required":true,"schema":{"type":"string"}},{"name":"x-rapidapi-key","in":"header","description":"Rapid API Token","required":true,"schema":{"type":"string"}},{"name":"teamIdOne","in":"query","required":true,"schema":{"example":10291175,"type":"number"}},{"name":"teamIdTwo","in":"query","required":true,"schema":{"example":10291176,"type":"number"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/BaseballMatchResponseDto"}}}}},"400":{"description":"Bad request descriptive error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestDto"}}}},"500":{"description":"Internal server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorDto"}}}}},"summary":"Get head 2 head games","tags":["Baseball.Head 2 Head"]}},"/lineups/{matchId}":{"get":{"description":"> Lineups should be queried up to a few hours before the game starts.\n\nRetrieve home and away team lineups for a specific match.\n\nBelow is an example of what you can aim to achieve with the lineup endpoint:\n\n![Nba lineups example](https://highlightly.net/assets/img/documentation/baseball/lineups.png)\n","operationId":"BaseballLineupsController_getLineups","parameters":[{"name":"x-rapidapi-host","in":"header","description":"mlb-college-baseball-api.p.rapidapi.com","required":true,"schema":{"type":"string"}},{"name":"x-rapidapi-key","in":"header","description":"Rapid API Token","required":true,"schema":{"type":"string"}},{"name":"matchId","required":true,"in":"path","description":"Requested match id.","schema":{"type":"number"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseballLineupsResponseDto"}}}},"400":{"description":"Bad request descriptive error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestDto"}}}},"500":{"description":"Internal server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorDto"}}}}},"summary":"Get linups by match id","tags":["Baseball.Lineups"]}},"/box-scores/{id}":{"get":{"description":"> Refresh interval: Every minute\n\nRetrieve detailed per-player **MLB box score statistics** by specifying the match `id` path parameter.\n\nThe response is an array with two elements:  \n`[homeTeam, awayTeam]`\n\nEach team object contains general team information and a list of player box scores, including both **batting** and **pitching** statistics.\n\n---\n\n## Team Structure\n\nEach team (home or away) has the following shape:\n\n| Field      | Description |\n|-----------|-------------|\n| id        | Unique identifier for the team. |\n| name      | Team name. |\n| logo      | Team logo identifier or URL, if available. |\n| boxScores | List of per-player box score records for the team. |\n\n---\n\n## Player Box Score\n\nEach item in `boxScores` represents a single player’s performance in the match.\n\n### Player Metadata\n\n| Field | Description |\n|------|-------------|\n| id   | Unique identifier for the player. |\n| name | Player’s display name. |\n\n---\n\n## Player Statistics\n\nPlayer performance data is provided as a list of statistic records.  \nEach record includes a statistic name, its category, and the recorded value.\n\n| Field | Description |\n|------|-------------|\n| name  | Name of the statistic (e.g. `Total At-Bats`, `Innings Pitched`). |\n| group | Statistic category (`Batting` or `Pitching`). |\n| value | Numeric value of the statistic. |\n\n---\n\n## Batting Statistics Explained\n\n- **Total At-Bats (AB)**  \n  Number of official at-bats for the player.\n\n- **Total Runs Scored (R)**  \n  Number of times the player scored a run.\n\n- **Total Hits (H)**  \n  Total number of hits recorded by the player.\n\n- **Total Runs Batted In (RBI)**  \n  Number of runs driven in by the player’s offensive actions.\n\n- **Total Home Runs (HR)**  \n  Number of home runs hit.\n\n- **Total Walks (BB)**  \n  Number of bases on balls earned.\n\n- **Total Strikeouts (SO)**  \n  Number of times the player struck out while batting.\n\n- **Total Pitches Thrown (Batting)**  \n  Total pitches seen by the player while at bat.\n\n- **Batting Average (AVG)**  \n  Hits divided by at-bats.\n\n- **On-Base Percentage (OBP)**  \n  Frequency at which the player reaches base safely.\n\n- **Slugging Percentage (SLG)**  \n  Measure of batting power based on total bases per at-bat.\n\n---\n\n## Pitching Statistics Explained\n\n- **Innings Pitched (IP)**  \n  Total number of innings pitched.\n\n- **Hits Allowed (H)**  \n  Number of hits allowed by the pitcher.\n\n- **Runs Allowed (R)**  \n  Total runs given up.\n\n- **Total Earned Runs (ER)**  \n  Runs that scored without defensive errors.\n\n- **Total Walks Allowed (BB)**  \n  Number of batters walked.\n\n- **Total Strikeouts (SO)**  \n  Number of batters struck out.\n\n- **Home Runs Allowed (HR)**  \n  Number of home runs conceded.\n\n- **Earned Run Average (ERA)**  \n  Average number of earned runs allowed per nine innings.\n\n- **Total Pitches Thrown (Pitching)**  \n  Total number of pitches thrown by the pitcher.\n\n---\n\n## Notes\n\n- A player may appear with **batting stats**, **pitching stats**, or both.\n- Some players may have zero values if they did not record a statistic in that category.\n- Statistic availability may vary depending on player participation in the match.\n\n","operationId":"BaseballBoxScoresController_getBoxScores","parameters":[{"name":"x-rapidapi-host","in":"header","description":"mlb-college-baseball-api.p.rapidapi.com","required":true,"schema":{"type":"string"}},{"name":"x-rapidapi-key","in":"header","description":"Rapid API Token","required":true,"schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Requested match id","schema":{"type":"number"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/BaseballPlayerBoxScoreMatchStatsResponseDto"}}}}},"400":{"description":"Bad request descriptive error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestDto"}}}},"500":{"description":"Internal server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorDto"}}}}},"summary":"Retrieve player box score for specified match id","tags":["Baseball.Match Box Score"]}},"/players":{"get":{"description":"> Refresh interval: 15 minutes\n\n> Route returns only general player information. For additional player details check the `players/{playerId}` and `players/{playerId}/statistics` routes. \n\nRetrieve a list of players based on the requested query parameters. \n\nReturned results will be paginated. The `limit` parameter defines what the number of returned players will be. If the number of actual players is above the `limit` value you can make subsequent requests by increasing the `offset` value.","operationId":"BaseballPlayersController_getPlayers","parameters":[{"name":"x-rapidapi-host","in":"header","description":"mlb-college-baseball-api.p.rapidapi.com","required":true,"schema":{"type":"string"}},{"name":"x-rapidapi-key","in":"header","description":"Rapid API Token","required":true,"schema":{"type":"string"}},{"required":false,"name":"name","in":"query","schema":{"example":"Reese Albert","type":"string"}},{"required":false,"name":"limit","in":"query","schema":{"minimum":0,"maximum":1000,"default":1000,"example":1000,"type":"number"}},{"required":false,"name":"offset","in":"query","schema":{"minimum":0,"default":0,"example":0,"type":"number"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseballPlayerPaginatedResponseDto"}}}},"400":{"description":"Bad request descriptive error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestDto"}}}},"500":{"description":"Internal server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorDto"}}}}},"summary":"Get all players","tags":["Baseball.Players"]}},"/players/{id}":{"get":{"description":"> Refresh interval: Once a day\n\nRetrieve detailed player summary by specifying the player `id` path parameter.\n\nDetailed player summary consists of the following information:\n\n| Type         | Description |\n| ------------ | ----------- |\n| Profile      | Provides a structured summary of a player's personal and professional profile. It includes key details such as current team affiliation, physical attributes (height, weight), biographical data (name, birth date, birthplace, citizenship), and playing positions. The data reflects both the player's current career status and positional versatility, offering a higher level overview which is useful for scouting, analysis, or profile display. |\n","operationId":"BaseballPlayersController_getPlayerSummaryById","parameters":[{"name":"x-rapidapi-host","in":"header","description":"mlb-college-baseball-api.p.rapidapi.com","required":true,"schema":{"type":"string"}},{"name":"x-rapidapi-key","in":"header","description":"Rapid API Token","required":true,"schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Requested player id.","schema":{"type":"number"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/BaseballDetailedPlayerSummaryResponseDto"}}}}},"400":{"description":"Bad request descriptive error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestDto"}}}},"500":{"description":"Internal server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorDto"}}}}},"summary":"Get player summary by player id","tags":["Baseball.Players"]}},"/players/{id}/statistics":{"get":{"description":"> Refresh interval: Once a day\n\nRetrieve detailed player statistics by specifying the player `id` path parameter.\n\nDetailed player statistics are aggregated on a `perSeason` level. Each season has the following available coverage:\n\n| Type               | Description                                                                 |\n|--------------------|-----------------------------------------------------------------------------|\n| Entire             | Combines both regular season and post-season statistics. Pre-season data is not included. |\n| Season             | Includes only regular season statistics.                               |\n\nRecorded stats are dependant on the player position. In total, the following stats are available:\n\n| Type | Description |\n|------|--------------|\n| Pitching | Statistics that measure a pitcher's performance in preventing runs and controlling opposing hitters (innings pitched, strikeouts, walks, earned runs). |\n| Batting | Statistics that measure a player's offensive performance at the plate, including hitting ability, power and on-base success (hits, batting average, home runs, RBIs). |\n\nNote: As mentioned earlier, statistics are associated with specific player positions. This means the results you receive will vary depending on the player's position.\n\n![Baseball Player stats example](https://highlightly.net/assets/img/documentation/baseball/player-stats.png)","operationId":"BaseballPlayersController_getPlayerStatisticsById","parameters":[{"name":"x-rapidapi-host","in":"header","description":"mlb-college-baseball-api.p.rapidapi.com","required":true,"schema":{"type":"string"}},{"name":"x-rapidapi-key","in":"header","description":"Rapid API Token","required":true,"schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Requested player id.","schema":{"type":"number"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/BaseballDetailedPlayerStatisticsResponseDto"}}}}},"400":{"description":"Bad request descriptive error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestDto"}}}},"500":{"description":"Internal server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorDto"}}}}},"summary":"Get player statistics by player id","tags":["Baseball.Players"]}},"/statistics/{id}":{"get":{"description":"> Refresh interval: Every minute\n\nRetrieve aggregated **MLB team statistics** for a single match by specifying the match `id` path parameter.\n\nThe response is an array with two elements:  \n`[teamA, teamB]`\n\nEach element represents a team and contains general team information along with aggregated statistics across **batting**, **pitching**, and **fielding**.\n\n---\n\n## Team Structure\n\nEach team object has the following shape:\n\n| Field | Description |\n|------|-------------|\n| id | Unique identifier for the team. |\n| name | Team name. |\n| logo | Team logo identifier or URL, if available. |\n| statistics | List of aggregated statistical records for the team. |\n\n---\n\n## Team Statistics\n\nEach item in `statistics` represents a single aggregated metric recorded during the match.\n\n### Statistic Record\n\n| Field | Description |\n|------|-------------|\n| name | Name of the statistic (e.g. `Total Hits`, `Earned Run Average`). |\n| group | Statistic category (`Batting`, `Pitching`, or `Fielding`). |\n| value | Numeric value of the statistic. |\n\n---\n\n## Batting Statistics\n\nBatting statistics summarize the team’s offensive performance.\n\n- **Total At Bats**  \n  Number of official team at-bats.\n\n- **Total Hits**  \n  Total number of hits recorded by the team.\n\n- **Total Runs**  \n  Total runs scored by the team.\n\n- **Total RBIs**  \n  Total runs driven in by the team’s offensive actions.\n\n- **Total Home Runs**  \n  Total home runs hit by the team.\n\n- **Total Walks**  \n  Total bases on balls earned.\n\n- **Total Strikeouts**  \n  Total strikeouts by batters.\n\n- **Batting Average (AVG)**  \n  Team hits divided by total at-bats.\n\n- **On-Base Percentage (OBP)**  \n  Frequency at which the team reaches base safely.\n\n- **Slugging Percentage (SLG)**  \n  Measure of team batting power based on total bases per at-bat.\n\n- **On-Base Plus Slugging (OPS)**  \n  Combined on-base and slugging percentage.\n\n---\n\n## Pitching Statistics\n\nPitching statistics summarize the team’s performance while pitching.\n\n- **Innings Pitched (IP)**  \n  Total innings pitched by the team.\n\n- **Hits Allowed (H)**  \n  Number of hits allowed by team pitchers.\n\n- **Runs Allowed (R)**  \n  Total runs conceded.\n\n- **Total Earned Runs (ER)**  \n  Runs that scored without defensive errors.\n\n- **Total Walks Allowed (BB)**  \n  Number of batters walked.\n\n- **Total Strikeouts (SO)**  \n  Number of batters struck out.\n\n- **Home Runs Allowed (HR)**  \n  Total home runs conceded.\n\n- **Earned Run Average (ERA)**  \n  Average number of earned runs allowed per nine innings.\n\n- **Total Pitches Thrown**  \n  Total number of pitches thrown by team pitchers.\n\n---\n\n## Fielding Statistics Explained\n\nFielding statistics summarize the team’s defensive performance.\n\n- **Total Putouts**  \n  Number of recorded outs by fielders.\n\n- **Total Assists**  \n  Number of assists recorded.\n\n- **Total Errors**  \n  Number of defensive errors committed.\n\n- **Total Chances**  \n  Total defensive chances.\n\n- **Fielding Percentage**  \n  Percentage of successful defensive plays.\n\n---\n\n## Notes\n\n- All statistics are **aggregated at the team level**.\n- Not all statistic categories or metrics are guaranteed to be present for every match.\n- Some values may be `0` depending on match flow and team participation.\n","operationId":"BaseballMatchStatisticsController_getStatistics","parameters":[{"name":"x-rapidapi-host","in":"header","description":"mlb-college-baseball-api.p.rapidapi.com","required":true,"schema":{"type":"string"}},{"name":"x-rapidapi-key","in":"header","description":"Rapid API Token","required":true,"schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Requested match id","schema":{"type":"number"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/BaseballMatchStatisticsResponseDto"}}}}},"400":{"description":"Bad request descriptive error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestDto"}}}}},"summary":"Returns detailed match statistics for given id","tags":["Baseball.Statistics"]}}},"info":{"title":"MLB & NCAA Baseball API Documentation","description":"The Highlightly MLB & NCAA Baseball API provides real-time baseball data including live scores, video highlights, box scores, match statistics, player profiles and stats, lineups, standings, predictions, head-to-head data, and live game events. Covers MLB American League, National League, Spring Training, playoffs, World Series, and NCAA Division I.\n\n## Contact\n\nFor feature requests, questions, private plans or business inquiries you can contact us at [support@highlightly.net](mailto:support@highlightly.net).\n\nYou can also contact us via [RapidAPI](https://rapidapi.com/highlightly-api-highlightly-api-default/api/mlb-college-baseball-api) by starting a discussion or by sending us a private message.\n\n# Integration\n\nTo start using our API services you will first need to create an account via [Highlightly](https://highlightly.net/login) or [RapidAPI](https://rapidapi.com/auth/sign-up?referral=/highlightly-api-highlightly-api-default/api/mlb-college-baseball-api/pricing). \nBoth platforms offer you the ability to view the API analytics, manage billing settings, control API keys and much more. However, there are a few differences. RapidAPI does not include custom plans nor does it provide long term plan discounts. \n\n> Accounts are **not** synced across platforms.\n\n> Please ensure that your API key is **not** made public to prevent potential abuse. Your API key can be managed either through Highlightly or RapidAPI.\n\n## API usage\n\n> Highlightly API base url: `https://baseball.highlightly.net`\n\n> RapidAPI API base url: `https://mlb-college-baseball-api.p.rapidapi.com`\n\nEach API request will be considered valid only if the following headers are present:\n\n| Request Header | Value |\n| ----------- | ----------- |\n| `x-rapidapi-key` | *Your Highlightly or RapidAPI API Key*       |\n| `x-rapidapi-host` | `mlb-college-baseball-api.p.rapidapi.com` - only needed for usage through RapidAPI |\n\nThese headers are mandatory when requesting API data. They are not needed when requesting other resources such as logos or images.\n\nEach API response will contain additional headers. The following three are considered the most important for developers:\n\n| Response Header   | Value |\n| ----------------  | ----------- |\n| `x-ratelimit-requests-limit`  | This is a static value indicating the number of requests **the plan** you are currently subscribed to allows you to make.       |\n| `x-ratelimit-requests-remaining` | The number of requests remaining (from your plan) before you reach the limit of requests your application is allowed to make. When this reaches zero, you will not be able to make any requests until your daily quota is reset. You can view these limits and quotas on the pricing page of the API in the API Hub. |\n| `content-type` | Value will always be `application/json`. XML format is not supported. |\n\nIn the following sections we will guide you through all endpoints and functionalities the API has to offer.","version":"6.3.2","contact":{}},"tags":[{"name":"MLB, NCAA Baseball API","description":""}],"servers":[{"url":"https://baseball.highlightly.net"},{"url":"https://mlb-college-baseball-api.p.rapidapi.com"}],"components":{"schemas":{"BaseballHighlightMatchTeamResponseDto":{"type":"object","properties":{"id":{"type":"number","example":219},"logo":{"type":"string","example":"https://example.com/logos/team/219.png"},"name":{"type":"string","example":"Bears"},"displayName":{"type":"string","example":"Baylor"},"abbreviation":{"type":"string","example":"BAY"}},"required":["id","displayName","abbreviation"]},"BaseballHighlightMatchResponseDto":{"type":"object","properties":{"id":{"type":"number","example":394},"round":{"type":"string","example":"regular-season"},"date":{"type":"string","example":"2024-03-06T00:30:00.000Z"},"league":{"type":"string","example":"NCAA"},"season":{"type":"number","example":2024},"awayTeam":{"$ref":"#/components/schemas/BaseballHighlightMatchTeamResponseDto"},"homeTeam":{"$ref":"#/components/schemas/BaseballHighlightMatchTeamResponseDto"}},"required":["id","round","date","league","season","awayTeam","homeTeam"]},"BaseballHighlightResponseDto":{"type":"object","properties":{"id":{"type":"number","example":27},"type":{"type":"string","example":"VERIFIED"},"imgUrl":{"type":"string","description":"Preview picture of the highlight.","example":"https://example.com/images/preview/27.png"},"title":{"type":"string","example":"NCAA: Bears vs Patriots"},"description":{"type":"string","example":"Tom Poole sends one deep to right to give Dallas Baptist an insurance run over Baylor."},"url":{"type":"string","description":"Url location of the video highlight.","example":"https://example.com/highlight/v23r23fds2cff"},"embedUrl":{"type":"string","description":"Url of embeddable video highlight.","example":"https://example.com/embed/v23r23fds2cff"},"match":{"$ref":"#/components/schemas/BaseballHighlightMatchResponseDto"},"channel":{"type":"string","example":"MLB","description":"Channel title of a given highlight."},"source":{"type":"string","example":"youtube","description":"Aggregation source from social media and other equivalent platforms."},"category":{"type":"string","example":"match-highlights","description":"Assumed highlight category"}},"required":["id","type","title","url","match"]},"PaginationResponseDto":{"type":"object","properties":{"totalCount":{"type":"number","description":"Available number of items, relevant to the provided query.","example":490},"offset":{"type":"number","example":20},"limit":{"type":"number","example":100}},"required":["totalCount","offset","limit"]},"PlanResponseDto":{"type":"object","properties":{"tier":{"type":"string","description":"Your current API subscription tier.","example":"BASIC"},"message":{"type":"string","description":"Explanation message regarding your current tier.","example":"Some results might be hidden with FREE tier. Check your API coverage for more information: https://rapidapi.com/highlightly-api-highlightly-api-default/api/sport-highlights-api/details"}},"required":["tier","message"]},"BaseballHighlightPaginatedResponseDto":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/BaseballHighlightResponseDto"}},"pagination":{"$ref":"#/components/schemas/PaginationResponseDto"},"plan":{"$ref":"#/components/schemas/PlanResponseDto"}},"required":["data","pagination","plan"]},"BadRequestDto":{"type":"object","properties":{"message":{"type":"string","example":"Descriptive bad request error message."},"statusCode":{"type":"number","example":400}},"required":["message","statusCode"]},"InternalServerErrorDto":{"type":"object","properties":{"message":{"type":"string","example":"Internal server error."},"statusCode":{"type":"number","example":500}},"required":["message","statusCode"]},"RestrictionResponseDto":{"type":"object","properties":{"state":{"type":"string","enum":["No restricitons applied","Allowed countries restriction","Blocked countries restriction","Unknown restrictions"],"example":"Allowed countries restriction","description":"Specifies which restriction rule is applied to the requested highlight. If allowed restriction is applied, read from allowedCountries field. When blocked restriction is applied, countries from blockedCountries field are applied."},"allowedCountries":{"example":["IT"],"description":"ISO 3166 two letter country list of allowed countries when restriction rules is in allowed state.","type":"array","items":{"type":"string"}},"blockedCountries":{"example":[],"description":"ISO 3166 two letter country list of blocked countries. Rule list is valid when restriction rules is in blocked state.","type":"array","items":{"type":"string"}},"embeddable":{"type":"boolean","example":true,"description":"Boolean flag which indicates whether highlight provider allows embedding inside web applications."}},"required":["state","allowedCountries","blockedCountries","embeddable"]},"BaseballMatchTeamResponseDto":{"type":"object","properties":{"id":{"type":"number","example":219},"logo":{"type":"string","example":"https://example.com/logos/team/219.png"},"name":{"type":"string","example":"Bears"},"displayName":{"type":"string","example":"Baylor"},"abbreviation":{"type":"string","example":"BAY"}},"required":["id","displayName","abbreviation"]},"BaseballMatchScore":{"type":"object","properties":{"hits":{"type":"number","example":4},"errors":{"type":"number","example":2},"innings":{"example":[0,0,1,1,0,0,1,1,1],"description":"Scores for each played inning.","type":"array","items":{"type":"string"}}},"required":["innings"]},"BaseballMatchScoreResponseDto":{"type":"object","properties":{"home":{"$ref":"#/components/schemas/BaseballMatchScore"},"away":{"$ref":"#/components/schemas/BaseballMatchScore"},"current":{"type":"string","example":"5 - 8"}},"required":["home","away"]},"BaseballMatchStateResponseDto":{"type":"object","properties":{"description":{"type":"string","enum":["Finished","Postponed","Period End","Rain Delay","Scheduled","Half Time","In Progress","Canceled","Unknown","Suspended","Abandoned"],"example":"Finished"},"report":{"type":"string","example":"Final","description":"Additional description of the match state."},"score":{"$ref":"#/components/schemas/BaseballMatchScoreResponseDto"}},"required":["description","score"]},"BaseballMatchResponseDto":{"type":"object","properties":{"id":{"type":"number","example":394},"round":{"type":"string","example":"regular-season"},"date":{"type":"string","example":"2024-03-06T00:30:00.000Z"},"league":{"type":"string","example":"NCAA"},"season":{"type":"number","example":2024},"awayTeam":{"$ref":"#/components/schemas/BaseballMatchTeamResponseDto"},"homeTeam":{"$ref":"#/components/schemas/BaseballMatchTeamResponseDto"},"state":{"$ref":"#/components/schemas/BaseballMatchStateResponseDto"}},"required":["id","round","date","league","season","awayTeam","homeTeam","state"]},"BaseballMatchPaginatedResponseDto":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/BaseballMatchResponseDto"}},"pagination":{"$ref":"#/components/schemas/PaginationResponseDto"},"plan":{"$ref":"#/components/schemas/PlanResponseDto"}},"required":["data","pagination","plan"]},"BaseballMatchVenueResponseDto":{"type":"object","properties":{"city":{"type":"string","example":"Waco"},"name":{"type":"string","example":"Baylor Ballpark"},"state":{"type":"string","example":"Texas"}},"required":["city","name","state"]},"BaseballTeamStatItemResponseDto":{"type":"object","properties":{"name":{"type":"string","example":"Total Strikeouts"},"value":{"type":"number","example":12},"group":{"type":"string","example":"Batting"}},"required":["name","value","group"]},"BaseballMatchTeamStatisticsResponseDto":{"type":"object","properties":{"id":{"type":"number","example":10291185},"name":{"type":"string","example":"Toronto Blue Jays"},"logo":{"type":"string","example":"https://highlightly.net/baseball/images/teams/10291185.png"},"statistics":{"type":"array","items":{"$ref":"#/components/schemas/BaseballTeamStatItemResponseDto"}}},"required":["id","name","statistics"]},"BaseballMatchStatisticsResponseDto":{"type":"object","properties":{"team":{"$ref":"#/components/schemas/BaseballMatchTeamStatisticsResponseDto"}},"required":["team"]},"BaseballDetailedAthleteMinimal":{"type":"object","properties":{"fullName":{"type":"string","example":"Will Baker"},"playerId":{"type":"number","example":1364867}},"required":["fullName","playerId"]},"BaseballDetailedMatchRunners":{"type":"object","properties":{"first":{"$ref":"#/components/schemas/BaseballDetailedAthleteMinimal"},"second":{"$ref":"#/components/schemas/BaseballDetailedAthleteMinimal"},"third":{"$ref":"#/components/schemas/BaseballDetailedAthleteMinimal"}}},"BaseballDetailedMatchPitch":{"type":"object","properties":{"type":{"type":"string","example":"CURVE"},"velocity":{"type":"number","example":78.2},"ballsCount":{"type":"number","example":0},"strikesCount":{"type":"number","example":0}}},"BaseballDetailedMatchResult":{"type":"object","properties":{"ballsCount":{"type":"number","example":1},"strikesCount":{"type":"number","example":2}}},"BaseballDetailedMatchScoreAtPlay":{"type":"object","properties":{"away":{"type":"number","example":1},"home":{"type":"number","example":2}}},"BaseballDetailedMatchPlaysDto":{"type":"object","properties":{"type":{"type":"string","example":"Start Inning"},"teamId":{"type":"number","example":229},"description":{"type":"string","example":"Top of the 1st inning"},"currentOuts":{"type":"number","example":0},"period":{"type":"string","example":"Top 1st Inning"},"runners":{"$ref":"#/components/schemas/BaseballDetailedMatchRunners"},"pitcher":{"$ref":"#/components/schemas/BaseballDetailedAthleteMinimal"},"batter":{"$ref":"#/components/schemas/BaseballDetailedAthleteMinimal"},"pitch":{"$ref":"#/components/schemas/BaseballDetailedMatchPitch"},"result":{"$ref":"#/components/schemas/BaseballDetailedMatchResult"},"score":{"$ref":"#/components/schemas/BaseballDetailedMatchScoreAtPlay"}},"required":["type","teamId","description","currentOuts","period","pitch","result","score"]},"BaseballDetailedMatchRefereesDto":{"type":"object","properties":{"name":{"type":"string","example":"Jonathan  Parra"},"position":{"type":"string","example":"Home Plate Umpire"}},"required":["name","position"]},"BaseballDetailedMatchRosterSingleDto":{"type":"object","properties":{"jersey":{"type":"number","example":1},"fullName":{"type":"string","example":"Hunter Hines"},"position":{"type":"string","example":"First Baseman"},"isStarter":{"type":"boolean","example":true}},"required":["fullName","position","isStarter"]},"BaseballDetailedMatchRostersDto":{"type":"object","properties":{"awayTeam":{"$ref":"#/components/schemas/BaseballDetailedMatchRosterSingleDto"},"homeTeam":{"$ref":"#/components/schemas/BaseballDetailedMatchRosterSingleDto"}},"required":["awayTeam","homeTeam"]},"DetailedMatchForecastResponseDto":{"type":"object","properties":{"status":{"type":"string","example":"cloudy"},"temperature":{"type":"string","example":"11.97°C"}}},"PredictionProbabilitiesDto":{"type":"object","properties":{"home":{"type":"string","example":"30.22%"},"draw":{"type":"string","example":"0.00%"},"away":{"type":"string","example":"69.78%"}},"required":["home","away"]},"PredictionDto":{"type":"object","properties":{"type":{"type":"string","example":"prematch"},"modelType":{"type":"string","example":"three-way"},"generatedAt":{"type":"string","example":"2025-03-12T19:00:20.000Z"},"description":{"type":"string","example":"Team A is most likely to win the game against Team B.`"},"probabilities":{"$ref":"#/components/schemas/PredictionProbabilitiesDto"}},"required":["type","modelType","generatedAt","description","probabilities"]},"PredictionResponseDto":{"type":"object","properties":{"prematch":{"type":"array","items":{"$ref":"#/components/schemas/PredictionDto"}},"live":{"type":"array","items":{"$ref":"#/components/schemas/PredictionDto"}}},"required":["prematch","live"]},"BaseballDetailedMatchResponseDto":{"type":"object","properties":{"id":{"type":"number","example":58348},"round":{"type":"string","example":"regular-season"},"date":{"type":"string","example":"2024-03-31T17:00:00.000Z"},"league":{"type":"string","example":"NCAA"},"season":{"type":"number","example":2024},"awayTeam":{"$ref":"#/components/schemas/BaseballMatchTeamResponseDto"},"homeTeam":{"$ref":"#/components/schemas/BaseballMatchTeamResponseDto"},"state":{"$ref":"#/components/schemas/BaseballMatchStateResponseDto"},"venue":{"$ref":"#/components/schemas/BaseballMatchVenueResponseDto"},"stats":{"type":"array","items":{"$ref":"#/components/schemas/BaseballMatchStatisticsResponseDto"}},"plays":{"type":"array","items":{"$ref":"#/components/schemas/BaseballDetailedMatchPlaysDto"}},"referees":{"type":"array","items":{"$ref":"#/components/schemas/BaseballDetailedMatchRefereesDto"}},"rosters":{"$ref":"#/components/schemas/BaseballDetailedMatchRostersDto"},"forecast":{"$ref":"#/components/schemas/DetailedMatchForecastResponseDto"},"predictions":{"$ref":"#/components/schemas/PredictionResponseDto"}},"required":["id","round","date","league","season","awayTeam","homeTeam","state"]},"BaseballTeamResponseDto":{"type":"object","properties":{"id":{"type":"number","example":219},"logo":{"type":"string","example":"https://example.com/logos/team/219.png"},"name":{"type":"string","example":"Bears"},"displayName":{"type":"string","example":"Baylor"},"abbreviation":{"type":"string","example":"BAY"},"league":{"type":"string","example":"NCAA"}},"required":["id","displayName","abbreviation","league"]},"BaseballTeamTotalGameStatsResponseDto":{"type":"object","properties":{"played":{"type":"number","description":"Number of games team has played during a specific league round.","example":102},"wins":{"type":"number","description":"Number of games team has won during a specific league round.","example":43},"loses":{"type":"number","description":"Number of games team has lost during a specific league round.","example":59}},"required":["played","wins","loses"]},"BaseballTeamTotalPointsStatsResponseDto":{"type":"object","properties":{"scored":{"type":"number","example":566,"description":"Number of points team has scored during a specific league round."},"received":{"type":"number","example":600,"description":"Number of points team has received during a specific league round."}},"required":["scored","received"]},"BaseballTeamTotalStatsResponseDto":{"type":"object","properties":{"games":{"description":"Number of games team has played, won, and lost during a specific league round.","allOf":[{"$ref":"#/components/schemas/BaseballTeamTotalGameStatsResponseDto"}]},"points":{"description":"Number of points team has scored, and received during a specific league round.","allOf":[{"$ref":"#/components/schemas/BaseballTeamTotalPointsStatsResponseDto"}]}},"required":["games","points"]},"BaseballTeamHomeGameStatsResponseDto":{"type":"object","properties":{"played":{"type":"number","description":"Number of games team has played as home team during a specific league round.","example":49},"wins":{"type":"number","description":"Number of games team has won as home team during a specific league round.","example":21},"loses":{"type":"number","description":"Number of games team has lost as home team during a specific league round.","example":28}},"required":["played","wins","loses"]},"BaseballTeamHomePointsStatsResponseDto":{"type":"object","properties":{"scored":{"type":"number","description":"Number of points team has scored whilst playing as home team during a specific league round.","example":263},"received":{"type":"number","description":"Number of points team has received whilst playing as home team during a specific league round.","example":300}},"required":["scored","received"]},"BaseballTeamHomeStatsResponseDto":{"type":"object","properties":{"games":{"description":"Number of games team has played, won, and lost during a specific league round, whilst playing as home team.","allOf":[{"$ref":"#/components/schemas/BaseballTeamHomeGameStatsResponseDto"}]},"points":{"description":"Number of points team has scored and received, during a specific league round, whilst playing as away team.","allOf":[{"$ref":"#/components/schemas/BaseballTeamHomePointsStatsResponseDto"}]}},"required":["games","points"]},"BaseballTeamAwayGameStatsResponseDto":{"type":"object","properties":{"played":{"type":"number","description":"Number of games team has played as home team during a specific league round.","example":53},"wins":{"type":"number","description":"Number of games team has won as home team during a specific league round.","example":22},"loses":{"type":"number","description":"Number of games team has lost as home team during a specific league round.","example":31}},"required":["played","wins","loses"]},"BaseballTeamAwayPointsStatsResponseDto":{"type":"object","properties":{"scored":{"type":"number","description":"Number of points team has scored as away team, during a specific league round.","example":303},"received":{"type":"number","description":"Number of points team has received as away team, during a specific league round.","example":300}},"required":["scored","received"]},"BaseballTeamAwayStatsResponseDto":{"type":"object","properties":{"games":{"description":"Game related statistics team has played as away team, during a specific league round.","allOf":[{"$ref":"#/components/schemas/BaseballTeamAwayGameStatsResponseDto"}]},"points":{"description":"Number of points team has scored and received as away team, during a specific league round.","allOf":[{"$ref":"#/components/schemas/BaseballTeamAwayPointsStatsResponseDto"}]}},"required":["games","points"]},"BaseballTeamStatisticsResponseDto":{"type":"object","properties":{"total":{"description":"Total game and points statistics corresponding to specific league round.","allOf":[{"$ref":"#/components/schemas/BaseballTeamTotalStatsResponseDto"}]},"home":{"description":"Game and point statistics corresponding to specific league round, where the team has played as a home team.","allOf":[{"$ref":"#/components/schemas/BaseballTeamHomeStatsResponseDto"}]},"away":{"description":"Game and point statistics corresponding to specific league round, where the team has played as an away team.","allOf":[{"$ref":"#/components/schemas/BaseballTeamAwayStatsResponseDto"}]},"leagueName":{"type":"string","example":"MLB","description":"League name to which team statistics are associated."},"round":{"type":"string","example":"regular-season","description":"Round to which team statistics are associated."}},"required":["total","home","away","leagueName","round"]},"BaseballStandingsTeamStatsResponseDto":{"type":"object","properties":{"description":{"type":"string","example":"Number of Overtime Losses"},"abbreviation":{"type":"string","example":"OTL"},"displayValue":{"type":"string","example":"0"}},"required":["description","abbreviation","displayValue"]},"BaseballStandingsTeamResponseDto":{"type":"object","properties":{"id":{"type":"number","example":58},"logo":{"type":"string","example":"https://example.com/baseball/images/teams/58.png"},"name":{"type":"string","example":"Dodgers"},"stats":{"type":"array","items":{"$ref":"#/components/schemas/BaseballStandingsTeamStatsResponseDto"}}},"required":["id","name","stats"]},"BaseballStandingsResponseDto":{"type":"object","properties":{"leagueName":{"type":"string","example":"Cactus League (MLB)"},"abbreviation":{"type":"string","example":"CAC"},"year":{"type":"number","example":2024},"leagueType":{"type":"string","example":"MLB"},"seasonType":{"type":"string","example":"Spring Training"},"startDate":{"type":"string","example":"2024-02-15T08:00:00.000Z"},"endDate":{"type":"string","example":"2024-03-27T06:59:00.000Z"},"data":{"type":"array","items":{"$ref":"#/components/schemas/BaseballStandingsTeamResponseDto"}}},"required":["leagueName","abbreviation","year","leagueType","seasonType","startDate","endDate","data"]},"BaseballStandingsPaginatedResponseDto":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/BaseballStandingsResponseDto"}},"pagination":{"$ref":"#/components/schemas/PaginationResponseDto"},"plan":{"$ref":"#/components/schemas/PlanResponseDto"}},"required":["data","pagination","plan"]},"BaseballMarketSelectionResponseDto":{"type":"object","properties":{"odd":{"type":"number","example":2.8},"value":{"type":"string","example":"Home"}},"required":["odd","value"]},"BaseballMarketResponseDto":{"type":"object","properties":{"bookmakerId":{"type":"number","example":53},"bookmakerName":{"type":"string","example":"Megapari Sport"},"type":{"type":"string","example":"prematch"},"market":{"type":"string","example":"Odd or Even"},"values":{"type":"array","items":{"$ref":"#/components/schemas/BaseballMarketSelectionResponseDto"}}},"required":["bookmakerId","type","market","values"]},"BaseballOddsResponseDto":{"type":"object","properties":{"matchId":{"type":"number","example":394},"odds":{"type":"array","items":{"$ref":"#/components/schemas/BaseballMarketResponseDto"}}},"required":["matchId","odds"]},"BaseballOddsPaginatedResponseDto":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/BaseballOddsResponseDto"}},"pagination":{"$ref":"#/components/schemas/PaginationResponseDto"},"plan":{"$ref":"#/components/schemas/PlanResponseDto"}},"required":["data","pagination","plan"]},"BaseballBookmakerResponseDto":{"type":"object","properties":{"id":{"type":"number","example":53},"name":{"type":"string","example":"Megapari Sport"}},"required":["id","name"]},"BaseballBookmakersPaginatedResponseDto":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/BaseballBookmakerResponseDto"}},"pagination":{"$ref":"#/components/schemas/PaginationResponseDto"},"plan":{"$ref":"#/components/schemas/PlanResponseDto"}},"required":["data","pagination","plan"]},"BaseballLineupsPlayerDto":{"type":"object","properties":{"id":{"type":"number","example":619412},"jersey":{"type":"number","example":22},"player":{"type":"string","example":"Parker Meadows"},"position":{"type":"string","example":"Center field"},"positionAbbreviation":{"type":"string","example":"CF"},"isStarter":{"type":"boolean","example":true}},"required":["id","player","position","positionAbbreviation"]},"BaseballLineupsDto":{"type":"object","properties":{"team":{"$ref":"#/components/schemas/BaseballTeamResponseDto"},"lineup":{"type":"array","items":{"$ref":"#/components/schemas/BaseballLineupsPlayerDto"}}},"required":["team","lineup"]},"BaseballLineupsResponseDto":{"type":"object","properties":{"home":{"$ref":"#/components/schemas/BaseballLineupsDto"},"away":{"$ref":"#/components/schemas/BaseballLineupsDto"}},"required":["home","away"]},"BaseballPlayerBoxScoreTeamResponseDto":{"type":"object","properties":{"id":{"type":"number","example":10291185},"name":{"type":"string","example":"Toronto Blue Jays"},"logo":{"type":"string","example":"https://highlightly.net/baseball/images/teams/10291185.png "}},"required":["id","name"]},"BaseballBoxScorePlayerResponseDto":{"type":"object","properties":{"id":{"type":"number","example":482237},"name":{"type":"string","example":"George Springer"}},"required":["id","name"]},"BaseballBoxScoreStatisticsItemResponseDto":{"type":"object","properties":{"name":{"type":"string","example":"Total At-Bats"},"group":{"type":"string","example":"Batting"},"value":{"type":"number","example":6}},"required":["name","group","value"]},"BaseballBoxScoreItemResponseDto":{"type":"object","properties":{"player":{"$ref":"#/components/schemas/BaseballBoxScorePlayerResponseDto"},"statistics":{"type":"array","items":{"$ref":"#/components/schemas/BaseballBoxScoreStatisticsItemResponseDto"}}},"required":["player","statistics"]},"BaseballPlayerBoxScoreMatchStatsResponseDto":{"type":"object","properties":{"team":{"$ref":"#/components/schemas/BaseballPlayerBoxScoreTeamResponseDto"},"boxScores":{"type":"array","items":{"$ref":"#/components/schemas/BaseballBoxScoreItemResponseDto"}}},"required":["team","boxScores"]},"BaseballPlayerResponseDto":{"type":"object","properties":{"id":{"type":"number","example":342182},"fullName":{"type":"string","example":"Reese Albert"},"logo":{"type":"string"}},"required":["id"]},"BaseballPlayerPaginatedResponseDto":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/BaseballPlayerResponseDto"}},"pagination":{"$ref":"#/components/schemas/PaginationResponseDto"},"plan":{"$ref":"#/components/schemas/PlanResponseDto"}},"required":["data","pagination","plan"]},"BaseballDetailedPlayerSummaryPositionDto":{"type":"object","properties":{"main":{"type":"string","example":"Unknown"},"abbreviation":{"type":"string","example":"UN"}}},"BaseballDetailedPlayerSummaryTeamDto":{"type":"object","properties":{"id":{"type":"number","example":10291561},"logo":{"type":"string","example":"https://highlightly.net/baseball/images/teams/10291561.png"},"name":{"type":"string","example":"Seminoles"},"league":{"type":"string","example":"MLB"},"displayName":{"type":"string","example":"Florida State"},"abbreviation":{"type":"string","example":"FSU"}},"required":["id","name","league","displayName","abbreviation"]},"BaseballDetailedPlayerSummaryProfileDto":{"type":"object","properties":{"fullName":{"type":"string","example":"Reese Albert"},"birthPlace":{"type":"string","example":"Jupiter, FL, United States"},"birthDate":{"type":"string","description":"DD.MM.YYYY format","example":"10.07.1999"},"height":{"type":"string","example":"6' 2\""},"jersey":{"type":"string"},"weight":{"type":"string","example":"190 lbs"},"isActive":{"type":"boolean","example":true},"debut":{"type":"number","description":"Player debut year"},"position":{"$ref":"#/components/schemas/BaseballDetailedPlayerSummaryPositionDto"},"team":{"$ref":"#/components/schemas/BaseballDetailedPlayerSummaryTeamDto"}},"required":["position","team"]},"BaseballDetailedPlayerSummaryResponseDto":{"type":"object","properties":{"id":{"type":"number","example":342182},"fullName":{"type":"string","example":"Reese Albert"},"logo":{"type":"string"},"profile":{"$ref":"#/components/schemas/BaseballDetailedPlayerSummaryProfileDto"}},"required":["id"]},"BaseballStatEntry":{"type":"object","properties":{"name":{"type":"string","example":"Player Hit By Pitch"},"value":{"type":"number","example":7},"category":{"type":"string","enum":["Pitching","Batting"],"example":"Batting"}},"required":["name","value","category"]},"BaseballDetailedPlayerStatisticsPerSeasonDto":{"type":"object","properties":{"stats":{"description":"Relevant stats for player position.","type":"array","items":{"$ref":"#/components/schemas/BaseballStatEntry"}},"teams":{"description":"Teams for which the player played in a given season.","type":"array","items":{"$ref":"#/components/schemas/BaseballDetailedPlayerSummaryTeamDto"}},"league":{"type":"string","example":"MLB"},"season":{"type":"number","example":2022},"seasonBreakdown":{"type":"string","enum":["Entire","Season"],"example":"Entire","description":"Represents the coverage for the stored statistics. Pre-season is never included."}},"required":["stats","teams","league","season","seasonBreakdown"]},"BaseballDetailedPlayerStatisticsResponseDto":{"type":"object","properties":{"id":{"type":"number","example":342182},"fullName":{"type":"string","example":"Reese Albert"},"logo":{"type":"string"},"perSeason":{"type":"array","items":{"$ref":"#/components/schemas/BaseballDetailedPlayerStatisticsPerSeasonDto"}}},"required":["id","perSeason"]}}}}