edgefinder schedule — NFL and NBA game schedules

Fetch the current NFL weekly schedule or today’s NBA games with edgefinder schedule. Use —date to look up any specific NBA game day.

The schedule command returns game schedules and scores for the NFL and NBA. For the NFL it retrieves the current week’s full slate of games. For the NBA it defaults to today’s games, and you can look up any date with the --date flag. All output is JSON by default — pipe it through jq or use it directly in scripts.

Syntax

edgefinder schedule <nfl|nba> [--date YYYY-MM-DD] [--json]

Arguments

path.league · string · required

The league to fetch the schedule for. Must be nfl or nba.

Options

query.--date · string

A specific date in YYYY-MM-DD format. Only applies to the NBA — the NBA schedule defaults to today when omitted. This flag has no effect for NFL.

query.--json · boolean

Output raw JSON. The schedule command always outputs JSON; this flag is accepted for consistency with other commands and for use in scripts that check for the flag explicitly.

Examples

NFL current week

edgefinder schedule nfl

Sample output

NFL

[
  {
    "gameId": "401671804",
    "homeTeam": "Kansas City Chiefs",
    "awayTeam": "Las Vegas Raiders",
    "date": "2026-01-04T18:00:00Z",
    "week": 18,
    "homeScore": null,
    "awayScore": null,
    "status": "scheduled"
  },
  {
    "gameId": "401671812",
    "homeTeam": "Dallas Cowboys",
    "awayTeam": "Philadelphia Eagles",
    "date": "2026-01-04T21:25:00Z",
    "week": 18,
    "homeScore": null,
    "awayScore": null,
    "status": "scheduled"
  }
]

NBA

[
  {
    "gameId": "401705123",
    "homeTeam": "Los Angeles Lakers",
    "awayTeam": "Boston Celtics",
    "date": "2026-02-20T00:30:00Z",
    "homeScore": null,
    "awayScore": null,
    "status": "scheduled"
  },
  {
    "gameId": "401705124",
    "homeTeam": "Golden State Warriors",
    "awayTeam": "Denver Nuggets",
    "date": "2026-02-20T03:00:00Z",
    "homeScore": 112,
    "awayScore": 108,
    "status": "final"
  }
]

The --date flag only applies to NBA. Passing --date with nfl as the league has no effect; the NFL schedule always returns the current week.

Pipe the output into jq to filter for specific teams or game statuses:

edgefinder schedule nba | jq '[.[] | select(.status == "scheduled")]'