Skip to main content
GET
List games

Notes

  • To authenticate, you’ll need a Tako API key. It’s best practice to store it as an environment variable to avoid hardcoding sensitive credentials in your code.
  • This is the subject lookup for sports monitors. Find the game or team here, then pass its id to Create a monitor.
  • Games come back soonest first. limit defaults to 100 and maxes at 500; pass a response’s next_cursor back as cursor for the next page.
  • Filter with league (a league id such as NBA or EPL, case-insensitive) and team (a team id, matched on either side of the game).
  • Rate limits are 60 requests a minute and 5,000 a day, per user.
  • home and away are null for events without teams, such as F1 and NASCAR. title is the only label those rows carry.

Which id goes where

Only a live_event row’s id works as a game_id. A row whose source is schedule_table is an FBS or FCS football game that only the football schedule table records — its id belongs to that table, no live document exists for it, and no monitor accepts it. Only live_event rows can carry odds.

The window

from and to are ISO 8601, and a naive value reads as UTC. They default to one day back and seven days ahead, which is the whole range the schedule covers — a window outside it is rejected with a 400. status defaults to scheduled,live, because a finished game can’t be monitored. Pass final to include the games that finished inside the one-day tail.

Reading odds_available

odds_available is true when the game document already holds a market. Prematch odds arrive inside a per-sport window, so a game further out reports false until that window opens. A monitor create works either way — a false here isn’t a reason to wait.

Authorizations

X-API-Key
string
header
required

Query Parameters

league
string

A league id, such as NBA or EPL. Case-insensitive.

team
string

A team id. Matches games where the team plays on either side.

from
string<date-time>

Window start, ISO 8601. Defaults to one day ago, which is the earliest the schedule covers. A naive value reads as UTC.

to
string<date-time>

Window end, ISO 8601. Defaults to seven days ahead, which is the furthest the schedule covers. A window outside that range is rejected.

status
string
default:scheduled,live

Keep only games in these states, comma-separated. Defaults to scheduled,live — a finished game can't be monitored. Pass final to include the games that finished inside the one-day lookback.

Examples:

"scheduled,live"

"final"

limit
integer
default:100

Games per page. Defaults to 100, maximum 500.

Required range: 1 <= x <= 500
cursor
string

The next_cursor from the previous page. Opaque; pass it back unchanged.

Response

Games in the window, soonest first

Games in the window, soonest first.

items
GameResponse · object[]
required
generated_at
string<date-time>
required
next_cursor
string | null

Pass as 'cursor' to get the next page. Null on the last page.