# ESPN API: Get team schedule

> Returns a team's past results and upcoming games for a season on ESPN, with opponents, local start times, scores, broadcasts and venues. Soccer fixtures include all competitions shown for the team.

Unofficial. Not affiliated with or endorsed by ESPN.

- Page: https://fous.com/methods/espn.com/get-team-schedule
- Method: `espn.com/get_team_schedule`, version 1
- Website: espn.com
- Returns: team, league, season, team link, and games with date_time, opponent, home_away, result, score, tv_network, venue, game_link, event_id
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `team` | string | yes | `"Dallas Cowboys"` | Team name, such as Dallas Cowboys or Real Madrid. |
| `league` | string | no |  | League to distinguish teams with similar names, such as NFL or Spanish LALIGA. Default "". |
| `season` | integer | no | `2025` | Starting year of the season, such as 2025 for 2025–26. Defaults to the current ESPN season. |
| `time_zone` | string | no |  | Time zone for game start times, such as US/Eastern or Europe/Madrid. Default "US/Eastern". |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "team": "Dallas Cowboys",
  "season": 2025
}
```

Its output:

```json
{
  "team": "Dallas Cowboys",
  "games": [
    {
      "score": "20-24",
      "venue": "Lincoln Financial Field",
      "result": "loss",
      "event_id": "401772510",
      "opponent": "Philadelphia Eagles",
      "date_time": "2025-09-04T20:20:00-04:00",
      "game_link": "https://www.espn.com/nfl/game/_/gameId/401772510/cowboys-eagles",
      "home_away": "away",
      "tv_network": "NBC, Peacock"
    },
    {
      "score": "40-37",
      "venue": "AT&T Stadium",
      "result": "win",
      "event_id": "401772834",
      "opponent": "New York Giants",
      "date_time": "2025-09-14T13:00:00-04:00",
      "game_link": "https://www.espn.com/nfl/game/_/gameId/401772834/giants-cowboys",
      "home_away": "home",
      "tv_network": "Fox"
    },
    {
      "score": "14-31",
      "venue": "Soldier Field",
      "result": "loss",
      "event_id": "401772844",
      "opponent": "Chicago Bears",
      "date_time": "2025-09-21T16:25:00-04:00",
      "game_link": "https://www.espn.com/nfl/game/_/gameId/401772844/cowboys-bears",
      "home_away": "away",
      "tv_network": "Fox"
    }
  ],
  "league": "NFL",
  "season": 2025,
  "team_id": "6",
  "team_link": "https://www.espn.com/nfl/team/_/name/dal/dallas-cowboys"
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"espn.com/get_team_schedule","input":{"team":"Dallas Cowboys","season":2025}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- What's the Real Madrid schedule for the 2025–26 season, with kickoff times in Europe/Madrid time?
- Show me every Dallas Cowboys game this season with opponents, scores, and TV networks.
- Can you pull the Boston Bruins results and upcoming games for 2024 on ESPN in US/Pacific time?
- I need the Liverpool fixtures across all competitions for the 2025 season, including venues and broadcast channels.
- List the Golden State Warriors past results and future games for the 2023 season, with local start times in US/Central.

## Input schema

```json
{
  "type": "object",
  "required": [
    "team"
  ],
  "properties": {
    "team": {
      "type": "string",
      "description": "Team name, such as Dallas Cowboys or Real Madrid."
    },
    "league": {
      "type": "string",
      "default": "",
      "description": "League to distinguish teams with similar names, such as NFL or Spanish LALIGA."
    },
    "season": {
      "type": "integer",
      "description": "Starting year of the season, such as 2025 for 2025–26. Defaults to the current ESPN season."
    },
    "time_zone": {
      "type": "string",
      "default": "US/Eastern",
      "description": "Time zone for game start times, such as US/Eastern or Europe/Madrid."
    }
  },
  "additionalProperties": false
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "team",
    "league",
    "season",
    "team_link",
    "team_id",
    "games"
  ],
  "properties": {
    "team": {
      "type": "string"
    },
    "games": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "date_time",
          "opponent",
          "home_away",
          "result",
          "score",
          "tv_network",
          "venue",
          "game_link",
          "event_id"
        ],
        "properties": {
          "score": {
            "type": [
              "string",
              "null"
            ],
            "description": "Team score followed by opponent score, or null before the result is final."
          },
          "venue": {
            "type": [
              "string",
              "null"
            ]
          },
          "result": {
            "enum": [
              "win",
              "loss",
              "tie",
              null
            ],
            "type": [
              "string",
              "null"
            ]
          },
          "event_id": {
            "type": "string"
          },
          "opponent": {
            "type": "string"
          },
          "date_time": {
            "type": [
              "string",
              "null"
            ],
            "description": "Local start time in ISO 8601 with offset, or null if not set."
          },
          "game_link": {
            "type": [
              "string",
              "null"
            ]
          },
          "home_away": {
            "enum": [
              "home",
              "away"
            ],
            "type": "string"
          },
          "tv_network": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "additionalProperties": false
      }
    },
    "league": {
      "type": "string"
    },
    "season": {
      "type": "integer"
    },
    "team_id": {
      "type": "string"
    },
    "team_link": {
      "type": "string"
    }
  },
  "additionalProperties": false
}
```

## See more

- [ESPN API: Get scores](https://fous.com/methods/espn.com/get-scores.md): Gets ESPN scores and the schedule for a league on a local day. You can filter by team, and start times are shown in your time zone.
- [ESPN API: Get game summary](https://fous.com/methods/espn.com/get-game-summary.md): Finds the latest game between two teams, or their game on a given date, in major US leagues, MLS or the EPL. Returns the score, scoring by period, leading players, team stats and player box scores.
- [ESPN API: List news for a league or team](https://fous.com/methods/espn.com/list-news.md): Finds an ESPN league or team by name and lists the latest headlines ESPN publishes for it, newest first.
- [ESPN API: Get player stats](https://fous.com/methods/espn.com/get-player-stats.md): Looks up an ESPN player by name and returns season and career statistics. Use a league to tell apart players with the same name, and a season year or label to pick a past season.
- [Yahoo API: Get scores](https://fous.com/methods/sports.yahoo.com/get-scores.md): Gets scores and schedules for a league on a date, or for the football week that contains the date. Results can be limited to one team. Venue names come from each game page, for up to 22 games.
- [Premier League API: Get fixtures and results](https://fous.com/methods/premierleague.com/get-fixtures-and-results.md): Gets Premier League fixtures and results in a date range, with kickoff times in your chosen time zone. Returns up to 380 matches.
- [MLB API: Get scores and schedule](https://fous.com/methods/mlb.com/get-scores.md): Lists MLB games and scores for a date or up to seven days, optionally for one team. Start times are shown in the requested time zone.
- [NFL API: Get scores](https://fous.com/methods/nfl.com/get-scores.md): Gets NFL scores and scheduled games for the week that contains a date. You can keep only one team's games. Kickoff times are in US Eastern time unless you choose another time zone.
- [All ESPN methods](https://fous.com/methods/espn.com.md)
