---
title: "Team game schedule (past and upcoming)"
method: GET
path: "/v1/{sport}/teams/{team}/schedule"
tags: ["Multi"]
---

# Team game schedule (past and upcoming)

`GET /v1/{sport}/teams/{team}/schedule`

## Request

- Base URL: `https://api.playcallerapp.com`
- URL: `https://api.playcallerapp.com/v1/{sport}/teams/{team}/schedule`
- Auth: API key in header `X-PlayCaller-Key`

Returns a team's game schedule — past results and upcoming games. NFL uses `nfl_games`; NBA, NHL, CFB, and Soccer use the ESPN live game feed. Filter by status to get only upcoming or only completed games.

**Tier access:** Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha

## Path parameters

- `sport` 'nfl' | 'nba' | 'nhl' | 'cfb' | 'soccer', required
- `team` string, required

## Query parameters

- `status` 'upcoming' | 'final' | 'live' | 'all'
- `season` integer
- `limit` integer

## Response `200`

Team schedule

- object
  - `success` boolean
  - `team` string
  - `sport` string
  - `count` integer
  - `data` object[]
    - `game_id` string
    - `game_date` string
    - `game_time` string
    - `status` string
    - `away` object
      - `name` string
      - `abbr` string
      - `score` integer
    - `home` object
      - `name` string
      - `abbr` string
      - `score` integer

## Other responses

- `401`: Missing or invalid API key
- `429`: Rate limit or monthly quota exceeded
- `500`: Internal server error

---

[API](https://skmtc.dev/playcallerapp/apis/playcaller-data-api.md) · [All operations](https://skmtc.dev/playcallerapp/apis/playcaller-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/playcallerapp/apis/playcaller-data-api/revisions/100c0a3ffbfe?raw)