Fixtures¶
GET /fixtures?league=<league>&date=<date>
The schedule: when games are played, who plays, and whether they are on. / answers the same.
| parameter | ||
|---|---|---|
league |
required | mlb, nba, nfl, cfb, nhl, epl, bund, laliga, ucl |
date |
optional | YYYY-MM-DD, or a range YYYY-MM-DD-YYYY-MM-DD (up to 31 days); a local date in the league's timezone, default today (see Dates) |
division |
optional, cfb only |
fbs or fcs: games with a team of that division |
Schedules cover the past 30 days and the next 30 (Bundesliga, LaLiga: 7). Older fixtures can be looked up by id.
curl -H "X-Api-Key: $KEY" "https://fixtures.halfpoint.tech/fixtures?league=nfl&date=2026-10-29"
{
"updated": "2026-10-29T23:36:43.479Z",
"league": {"id": "nfl", "name": "NFL", "sport": "Football"},
"fixtures": [
{
"id": "nfl-261029-car-gb",
"date": "2026-10-30T00:15:00.000Z",
"teams": {
"away": {"id": "nfl-car", "name": "Carolina Panthers", "abbreviation": "CAR"},
"home": {"id": "nfl-gb", "name": "Green Bay Packers", "abbreviation": "GB"}
},
"status": "Scheduled",
"original_date": "2026-10-30T00:15:00.000Z"
}
]
}
Fixtures are ordered by start.
| field | |
|---|---|
id |
the fixture id (see Fixture ids) |
date |
current scheduled, or actual, start (UTC) |
teams.away, teams.home |
id, name, abbreviation; for college also division (FBS, FCS) and conference, as of the game |
status |
see Statuses |
original_date |
the start as of the date lock |
detail |
the reason, if any |
replaces, replaced_by |
postponement links (see Postponements) |
final_at |
when the final score was confirmed |
corrected_at |
when a final score was corrected |
Fields without a value are left out. updated is when our data last changed.