Skip to content

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.