A query to this endpoint without a numeric game code(s) will return a list of all games for the competition level with their game codes, in reverse chronological order. Results can be filtered by season, sublevel, team, date or date range. Passing a game code will return all metadata for the game, a rundown of scoring plays, in-game score datapoints and play by play if available, and a summary of game forecasts (ELO probability, moneyline, spread and simulation).
Please note that this endpoint can be used synonymously as game.
Controls the data format by which query results are returned. Acceptable values are xml, json or php. The default value is json. Example: https://api3.natst.at/xxxx-xxxxxx/games/nba/xml
season
optional
range
A valid season code (the year when a particular season completes) in YYYY format. A list of available values can be retrieved from the seasons endpoint. Example: https://api3.natst.at/xxxx-xxxxxx/games/nba/2025
date
optional
range
A date in YYYY-MM-DD format. Example: https://api3.natst.at/xxxx-xxxxxx/games/nba/2025-03-23
daterange
optional
range
Two dates in YYYY-MM-DD format. Any additional dates beyond two will be ignored. Example: https://api3.natst.at/xxxx-xxxxxx/games/nba/2025-03-23,2025-03-30
teamcode
optional
range
A two to eight-character code for a team. A list of available values can be retrieved from the /teamcodes endpoint or the lookup below. Example: https://api3.natst.at/xxxx-xxxxxx/games/nba/XXX
leaguecode
optional
range
A two to eight-character code for a league. A list of available values can be retrieved from the /leaguecodes endpoint or the lookup below. Example: https://api3.natst.at/xxxx-xxxxxx/games/eurobb/XXX
playercode
optional
range
A numeric code for a player. A list of available values can be retrieved from the /players endpoint. Example: https://api3.natst.at/xxxx-xxxxxx/games/nba/XXX
gamecode
optional
range
A numeric code for an game. A list of available values can be retrieved by querying this endpoint with no range parameter. Example: https://api3.natst.at/xxxx-xxxxxx/games/nba/XXX
search
optional
range
If a comma-separated value is none of the above, the API will assume it is a search term. The system will only accept the first entry in a string as a search term. Example: https://api3.natst.at/xxxx-xxxxxx/games/nba/XXX
Query
Name
Required
Type
Description
key
required
path
A valid API key in xxxx-xxxxxx format. This must be the first path parameter. Example: https://api3.natst.at/xxxx-xxxxxx/...
Path
Name
Required
Type
Description
endpoint
required
path
The API endpoint to query. This must be the second path parameter. Example: https://api3.natst.at/xxxx-xxxxxx/games/...
level
required
path
One of 30 NatStat data services to query. A full list can be found in the documentation. This must be the third path parameter. Example: https://api3.natst.at/xxxx-xxxxxx/games/nhl/...
