Documentation / Guides
How fresh the data is
When results, detail and odds arrive, the same on every plan.| What | How often | Where |
|---|---|---|
| Play by play during the game | Every minute while a North American top league game is on | /v1/games/{game_id}/events, with meta.live |
| Start times, scores, how games ended, postponements | Every 10 minutes, in more than a thousand leagues | /v1/games, /v1/results |
| Box scores: lineups, skater and goalie lines, penalties, officials, coaches, attendance | Hourly, after the final horn | The endpoints inside a game |
| A full sweep of every result, and closing odds | Twice a day, 07:10 and 19:10 UTC | /v1/odds, /v1/games/{game_id}/odds |
| Players and careers | Daily | /v1/players |
A game while it is played
A game being played has status live. For North American top league games, meta.live on the events endpoint gives the period, the clock, the score and the shots as they stand, read again every minute. Other leagues show the result within about ten minutes of the end.
Times
Every time is UTC. A game's date is the day it was played where it was played; start_time is the face-off in UTC.