> ## Documentation Index
> Fetch the complete documentation index at: https://edgefinder.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

```bash theme={null}
edgefinder schedule <nfl|nba> [--date YYYY-MM-DD] [--json]
```

## Arguments

<ParamField path="path.league" type="string" required>
  The league to fetch the schedule for. Must be `nfl` or `nba`.
</ParamField>

## Options

<ParamField path="query.--date" type="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.
</ParamField>

<ParamField path="query.--json" type="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.
</ParamField>

## Examples

<CodeGroup>
  ```bash NFL current week theme={null}
  edgefinder schedule nfl
  ```

  ```bash NBA today theme={null}
  edgefinder schedule nba
  ```

  ```bash NBA specific date theme={null}
  edgefinder schedule nba --date 2026-02-20
  ```

  ```bash NFL as JSON theme={null}
  edgefinder schedule nfl --json
  ```
</CodeGroup>

### Sample output

<Tabs>
  <Tab title="NFL">
    ```json theme={null}
    [
      {
        "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"
      }
    ]
    ```
  </Tab>

  <Tab title="NBA">
    ```json theme={null}
    [
      {
        "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"
      }
    ]
    ```
  </Tab>
</Tabs>

<Note>
  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.
</Note>

<Tip>
  Pipe the output into `jq` to filter for specific teams or game statuses:

  ```bash theme={null}
  edgefinder schedule nba | jq '[.[] | select(.status == "scheduled")]'
  ```
</Tip>