Skip to content

Game Schedule

griddy / nfl / endpoints / pro / mixins / game_schedule**

game_schedule

Classes

GameScheduleMixin

Mixin for game schedule-related endpoints.

These methods are designed to be mixed into classes that inherit from ProSDK/BaseSDK, which provides the helper methods (_resolve_base_url, _resolve_timeout, etc.).

Functions
get_scheduled_game 
get_scheduled_game(
    *,
    game_id: str,
    retries: OptionalNullable[RetryConfig] = UNSET,
    server_url: Optional[str] = None,
    timeout_ms: Optional[int] = None,
    http_headers: Optional[Mapping[str, str]] = None
) -> GameDetail

Get Single Game Details

Retrieves detailed information for a specific game by its ID. Returns comprehensive game data including teams, score, venue, broadcast information, and current game status.

:param game_id: Game identifier (UUID format) :param retries: Override the default retry configuration for this method :param server_url: Override the default server URL for this method :param timeout_ms: Override the default request timeout configuration for this method in milliseconds :param http_headers: Additional headers to set or replace on requests.

Source code in griddy/nfl/endpoints/pro/mixins/game_schedule.py 
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
def get_scheduled_game(
    self,
    *,
    game_id: str,
    retries: OptionalNullable[utils.RetryConfig] = UNSET,
    server_url: Optional[str] = None,
    timeout_ms: Optional[int] = None,
    http_headers: Optional[Mapping[str, str]] = None,
) -> models.GameDetail:
    r"""Get Single Game Details

    Retrieves detailed information for a specific game by its ID.
    Returns comprehensive game data including teams, score, venue, broadcast information,
    and current game status.


    :param game_id: Game identifier (UUID format)
    :param retries: Override the default retry configuration for this method
    :param server_url: Override the default server URL for this method
    :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
    :param http_headers: Additional headers to set or replace on requests.
    """
    config = self._get_scheduled_game_config(
        game_id=game_id,
        retries=retries,
        server_url=server_url,
        timeout_ms=timeout_ms,
        http_headers=http_headers,
    )
    return self._execute_endpoint(config)
get_scheduled_game_async async 
get_scheduled_game_async(
    *,
    game_id: str,
    retries: OptionalNullable[RetryConfig] = UNSET,
    server_url: Optional[str] = None,
    timeout_ms: Optional[int] = None,
    http_headers: Optional[Mapping[str, str]] = None
) -> GameDetail

Get Single Game Details

Retrieves detailed information for a specific game by its ID. Returns comprehensive game data including teams, score, venue, broadcast information, and current game status.

:param game_id: Game identifier (UUID format) :param retries: Override the default retry configuration for this method :param server_url: Override the default server URL for this method :param timeout_ms: Override the default request timeout configuration for this method in milliseconds :param http_headers: Additional headers to set or replace on requests.

Source code in griddy/nfl/endpoints/pro/mixins/game_schedule.py 
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
async def get_scheduled_game_async(
    self,
    *,
    game_id: str,
    retries: OptionalNullable[utils.RetryConfig] = UNSET,
    server_url: Optional[str] = None,
    timeout_ms: Optional[int] = None,
    http_headers: Optional[Mapping[str, str]] = None,
) -> models.GameDetail:
    r"""Get Single Game Details

    Retrieves detailed information for a specific game by its ID.
    Returns comprehensive game data including teams, score, venue, broadcast information,
    and current game status.


    :param game_id: Game identifier (UUID format)
    :param retries: Override the default retry configuration for this method
    :param server_url: Override the default server URL for this method
    :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
    :param http_headers: Additional headers to set or replace on requests.
    """
    config = self._get_scheduled_game_config(
        game_id=game_id,
        retries=retries,
        server_url=server_url,
        timeout_ms=timeout_ms,
        http_headers=http_headers,
    )
    return await self._execute_endpoint_async(config)
get_game_matchup_rankings 
get_game_matchup_rankings(
    *,
    game_id: str,
    retries: OptionalNullable[RetryConfig] = UNSET,
    server_url: Optional[str] = None,
    timeout_ms: Optional[int] = None,
    http_headers: Optional[Mapping[str, str]] = None
) -> MatchupRankingsResponse

Get Game Matchup Rankings

Retrieves comprehensive matchup rankings and statistical comparisons for both teams in a specific game. Returns offensive, defensive, and special teams rankings with Z-scores and advantage ratings for various statistical categories.

:param game_id: Game identifier (10-digit format YYYYMMDDNN) :param retries: Override the default retry configuration for this method :param server_url: Override the default server URL for this method :param timeout_ms: Override the default request timeout configuration for this method in milliseconds :param http_headers: Additional headers to set or replace on requests.

Source code in griddy/nfl/endpoints/pro/mixins/game_schedule.py 
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
def get_game_matchup_rankings(
    self,
    *,
    game_id: str,
    retries: OptionalNullable[utils.RetryConfig] = UNSET,
    server_url: Optional[str] = None,
    timeout_ms: Optional[int] = None,
    http_headers: Optional[Mapping[str, str]] = None,
) -> models.MatchupRankingsResponse:
    r"""Get Game Matchup Rankings

    Retrieves comprehensive matchup rankings and statistical comparisons for both teams in a specific game.
    Returns offensive, defensive, and special teams rankings with Z-scores and advantage ratings
    for various statistical categories.


    :param game_id: Game identifier (10-digit format YYYYMMDDNN)
    :param retries: Override the default retry configuration for this method
    :param server_url: Override the default server URL for this method
    :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
    :param http_headers: Additional headers to set or replace on requests.
    """
    config = self._get_game_matchup_rankings_config(
        game_id=game_id,
        retries=retries,
        server_url=server_url,
        timeout_ms=timeout_ms,
        http_headers=http_headers,
    )
    return self._execute_endpoint(config)
get_game_matchup_rankings_async async 
get_game_matchup_rankings_async(
    *,
    game_id: str,
    retries: OptionalNullable[RetryConfig] = UNSET,
    server_url: Optional[str] = None,
    timeout_ms: Optional[int] = None,
    http_headers: Optional[Mapping[str, str]] = None
) -> MatchupRankingsResponse

Get Game Matchup Rankings

Retrieves comprehensive matchup rankings and statistical comparisons for both teams in a specific game. Returns offensive, defensive, and special teams rankings with Z-scores and advantage ratings for various statistical categories.

:param game_id: Game identifier (10-digit format YYYYMMDDNN) :param retries: Override the default retry configuration for this method :param server_url: Override the default server URL for this method :param timeout_ms: Override the default request timeout configuration for this method in milliseconds :param http_headers: Additional headers to set or replace on requests.

Source code in griddy/nfl/endpoints/pro/mixins/game_schedule.py 
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
async def get_game_matchup_rankings_async(
    self,
    *,
    game_id: str,
    retries: OptionalNullable[utils.RetryConfig] = UNSET,
    server_url: Optional[str] = None,
    timeout_ms: Optional[int] = None,
    http_headers: Optional[Mapping[str, str]] = None,
) -> models.MatchupRankingsResponse:
    r"""Get Game Matchup Rankings

    Retrieves comprehensive matchup rankings and statistical comparisons for both teams in a specific game.
    Returns offensive, defensive, and special teams rankings with Z-scores and advantage ratings
    for various statistical categories.


    :param game_id: Game identifier (10-digit format YYYYMMDDNN)
    :param retries: Override the default retry configuration for this method
    :param server_url: Override the default server URL for this method
    :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
    :param http_headers: Additional headers to set or replace on requests.
    """
    config = self._get_game_matchup_rankings_config(
        game_id=game_id,
        retries=retries,
        server_url=server_url,
        timeout_ms=timeout_ms,
        http_headers=http_headers,
    )
    return await self._execute_endpoint_async(config)
get_game_team_rankings 
get_game_team_rankings(
    *,
    season: int,
    season_type: SeasonTypeEnum,
    away_team_id: str,
    home_team_id: str,
    week: int,
    retries: OptionalNullable[RetryConfig] = UNSET,
    server_url: Optional[str] = None,
    timeout_ms: Optional[int] = None,
    http_headers: Optional[Mapping[str, str]] = None
) -> TeamRankingsResponse

Get Team Rankings for Game

Retrieves comprehensive statistical rankings for both teams in a specific game. Returns 300+ statistical categories with rankings for offensive, defensive, and special teams performance.

:param season: Season year :param season_type: Type of season :param away_team_id: Away team UUID :param home_team_id: Home team UUID :param week: Week number :param retries: Override the default retry configuration for this method :param server_url: Override the default server URL for this method :param timeout_ms: Override the default request timeout configuration for this method in milliseconds :param http_headers: Additional headers to set or replace on requests.

Source code in griddy/nfl/endpoints/pro/mixins/game_schedule.py 
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
def get_game_team_rankings(
    self,
    *,
    season: int,
    season_type: models.SeasonTypeEnum,
    away_team_id: str,
    home_team_id: str,
    week: int,
    retries: OptionalNullable[utils.RetryConfig] = UNSET,
    server_url: Optional[str] = None,
    timeout_ms: Optional[int] = None,
    http_headers: Optional[Mapping[str, str]] = None,
) -> models.TeamRankingsResponse:
    r"""Get Team Rankings for Game

    Retrieves comprehensive statistical rankings for both teams in a specific game.
    Returns 300+ statistical categories with rankings for offensive, defensive, and special teams performance.


    :param season: Season year
    :param season_type: Type of season
    :param away_team_id: Away team UUID
    :param home_team_id: Home team UUID
    :param week: Week number
    :param retries: Override the default retry configuration for this method
    :param server_url: Override the default server URL for this method
    :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
    :param http_headers: Additional headers to set or replace on requests.
    """
    config = self._get_game_team_rankings_config(
        season=season,
        season_type=season_type,
        away_team_id=away_team_id,
        home_team_id=home_team_id,
        week=week,
        retries=retries,
        server_url=server_url,
        timeout_ms=timeout_ms,
        http_headers=http_headers,
    )
    return self._execute_endpoint(config)
get_game_team_rankings_async async 
get_game_team_rankings_async(
    *,
    season: int,
    season_type: SeasonTypeEnum,
    away_team_id: str,
    home_team_id: str,
    week: int,
    retries: OptionalNullable[RetryConfig] = UNSET,
    server_url: Optional[str] = None,
    timeout_ms: Optional[int] = None,
    http_headers: Optional[Mapping[str, str]] = None
) -> TeamRankingsResponse

Get Team Rankings for Game

Retrieves comprehensive statistical rankings for both teams in a specific game. Returns 300+ statistical categories with rankings for offensive, defensive, and special teams performance.

:param season: Season year :param season_type: Type of season :param away_team_id: Away team UUID :param home_team_id: Home team UUID :param week: Week number :param retries: Override the default retry configuration for this method :param server_url: Override the default server URL for this method :param timeout_ms: Override the default request timeout configuration for this method in milliseconds :param http_headers: Additional headers to set or replace on requests.

Source code in griddy/nfl/endpoints/pro/mixins/game_schedule.py 
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
async def get_game_team_rankings_async(
    self,
    *,
    season: int,
    season_type: models.SeasonTypeEnum,
    away_team_id: str,
    home_team_id: str,
    week: int,
    retries: OptionalNullable[utils.RetryConfig] = UNSET,
    server_url: Optional[str] = None,
    timeout_ms: Optional[int] = None,
    http_headers: Optional[Mapping[str, str]] = None,
) -> models.TeamRankingsResponse:
    r"""Get Team Rankings for Game

    Retrieves comprehensive statistical rankings for both teams in a specific game.
    Returns 300+ statistical categories with rankings for offensive, defensive, and special teams performance.


    :param season: Season year
    :param season_type: Type of season
    :param away_team_id: Away team UUID
    :param home_team_id: Home team UUID
    :param week: Week number
    :param retries: Override the default retry configuration for this method
    :param server_url: Override the default server URL for this method
    :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
    :param http_headers: Additional headers to set or replace on requests.
    """
    config = self._get_game_team_rankings_config(
        season=season,
        season_type=season_type,
        away_team_id=away_team_id,
        home_team_id=home_team_id,
        week=week,
        retries=retries,
        server_url=server_url,
        timeout_ms=timeout_ms,
        http_headers=http_headers,
    )
    return await self._execute_endpoint_async(config)
get_team_injuries 
get_team_injuries(
    *,
    season: int,
    season_type: SeasonTypeEnum,
    team_id: str,
    week: int,
    retries: OptionalNullable[RetryConfig] = UNSET,
    server_url: Optional[str] = None,
    timeout_ms: Optional[int] = None,
    http_headers: Optional[Mapping[str, str]] = None
) -> InjuryReportResponse

Get Team Injuries for Game Week

Retrieves injury report information for a specific team in a given week. Returns player injury status and details for the specified team and week.

:param season: Season year :param season_type: Type of season :param team_id: Team identifier (UUID format) :param week: Week number within the season :param retries: Override the default retry configuration for this method :param server_url: Override the default server URL for this method :param timeout_ms: Override the default request timeout configuration for this method in milliseconds :param http_headers: Additional headers to set or replace on requests.

Source code in griddy/nfl/endpoints/pro/mixins/game_schedule.py 
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
def get_team_injuries(
    self,
    *,
    season: int,
    season_type: models.SeasonTypeEnum,
    team_id: str,
    week: int,
    retries: OptionalNullable[utils.RetryConfig] = UNSET,
    server_url: Optional[str] = None,
    timeout_ms: Optional[int] = None,
    http_headers: Optional[Mapping[str, str]] = None,
) -> models.InjuryReportResponse:
    r"""Get Team Injuries for Game Week

    Retrieves injury report information for a specific team in a given week.
    Returns player injury status and details for the specified team and week.


    :param season: Season year
    :param season_type: Type of season
    :param team_id: Team identifier (UUID format)
    :param week: Week number within the season
    :param retries: Override the default retry configuration for this method
    :param server_url: Override the default server URL for this method
    :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
    :param http_headers: Additional headers to set or replace on requests.
    """
    config = self._get_team_injuries_config(
        season=season,
        season_type=season_type,
        team_id=team_id,
        week=week,
        retries=retries,
        server_url=server_url,
        timeout_ms=timeout_ms,
        http_headers=http_headers,
    )
    return self._execute_endpoint(config)
get_team_injuries_async async 
get_team_injuries_async(
    *,
    season: int,
    season_type: SeasonTypeEnum,
    team_id: str,
    week: int,
    retries: OptionalNullable[RetryConfig] = UNSET,
    server_url: Optional[str] = None,
    timeout_ms: Optional[int] = None,
    http_headers: Optional[Mapping[str, str]] = None
) -> InjuryReportResponse

Get Team Injuries for Game Week

Retrieves injury report information for a specific team in a given week. Returns player injury status and details for the specified team and week.

:param season: Season year :param season_type: Type of season :param team_id: Team identifier (UUID format) :param week: Week number within the season :param retries: Override the default retry configuration for this method :param server_url: Override the default server URL for this method :param timeout_ms: Override the default request timeout configuration for this method in milliseconds :param http_headers: Additional headers to set or replace on requests.

Source code in griddy/nfl/endpoints/pro/mixins/game_schedule.py 
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
async def get_team_injuries_async(
    self,
    *,
    season: int,
    season_type: models.SeasonTypeEnum,
    team_id: str,
    week: int,
    retries: OptionalNullable[utils.RetryConfig] = UNSET,
    server_url: Optional[str] = None,
    timeout_ms: Optional[int] = None,
    http_headers: Optional[Mapping[str, str]] = None,
) -> models.InjuryReportResponse:
    r"""Get Team Injuries for Game Week

    Retrieves injury report information for a specific team in a given week.
    Returns player injury status and details for the specified team and week.


    :param season: Season year
    :param season_type: Type of season
    :param team_id: Team identifier (UUID format)
    :param week: Week number within the season
    :param retries: Override the default retry configuration for this method
    :param server_url: Override the default server URL for this method
    :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
    :param http_headers: Additional headers to set or replace on requests.
    """
    config = self._get_team_injuries_config(
        season=season,
        season_type=season_type,
        team_id=team_id,
        week=week,
        retries=retries,
        server_url=server_url,
        timeout_ms=timeout_ms,
        http_headers=http_headers,
    )
    return await self._execute_endpoint_async(config)