---
title: "Schedules by Season ID and Team ID"
method: GET
path: "/football/schedules/seasons/{seasonId}/teams/{teamId}"
tags: ["Schedules"]
---

# Schedules by Season ID and Team ID

`GET /football/schedules/seasons/{seasonId}/teams/{teamId}`

## Request

- Base URL: `https://api.sportmonks.com/v3`
- URL: `https://api.sportmonks.com/v3/football/schedules/seasons/{seasonId}/teams/{teamId}`
- Auth: one of:
  - API key in query parameter `api_token`
  - API key in header `Authorization`

Returns the complete season schedule for one specific team from your requested season ID. For more information, please visit:https://docs.sportmonks.com/football/endpoints-and-entities/endpoints/schedules/get-schedules-by-season-id-and-team-id

[Sportmonks documentation](https://docs.sportmonks.com/football/endpoints-and-entities/endpoints/schedules/get-schedules-by-season-id-and-team-id)

## Path parameters

- `seasonId` integer, required
- `teamId` integer, required

## Query parameters

- `include` string
- `select` string[]
- `filters` string
- `locale` string

## Response `200`

Success.

- object
  - `data` StageRoundFixtures[], required
    - `id` integer
    - `sport_id` integer
    - `league_id` integer
    - `season_id` integer
    - `type_id` integer
    - `name` string
    - `sort_order` integer
    - `finished` boolean
    - `is_current` boolean
    - `starting_at` string: Timestamp in `YYYY-MM-DD HH:MM:SS` UTC format (not ISO 8601).
    - `ending_at` string: Timestamp in `YYYY-MM-DD HH:MM:SS` UTC format (not ISO 8601).
    - `games_in_current_week` boolean
    - `tie_breaker_rule_id` unknown
    - `rounds` object[]
      - `id` integer
      - `sport_id` integer
      - `league_id` integer
      - `season_id` integer
      - `stage_id` integer
      - `name` string
      - `finished` boolean
      - `is_current` boolean
      - `starting_at` string: Timestamp in `YYYY-MM-DD HH:MM:SS` UTC format (not ISO 8601).
      - `ending_at` string: Timestamp in `YYYY-MM-DD HH:MM:SS` UTC format (not ISO 8601).
      - `games_in_current_week` boolean
      - `fixtures` object[]
        - `id` integer
        - `sport_id` integer
        - `league_id` integer
        - `season_id` integer
        - `stage_id` integer
        - `group_id` unknown
        - `aggregate_id` unknown
        - `round_id` integer
        - `state_id` integer
        - `venue_id` integer
        - `name` string
        - `starting_at` string: Timestamp in `YYYY-MM-DD HH:MM:SS` UTC format (not ISO 8601).
        - `result_info` string, nullable
        - `leg` string
        - `details` unknown
        - `length` integer
        - `placeholder` boolean
        - `has_odds` boolean
        - `has_premium_odds` boolean
        - `starting_at_timestamp` integer
        - `participants` object[]
          - `id` integer
          - `sport_id` integer
          - `country_id` integer
          - `venue_id` integer
          - `gender` string
          - `name` string
          - `short_code` string
          - `image_path` string
          - `founded` integer
          - `type` string
          - `placeholder` boolean
          - `last_played_at` string: Timestamp in `YYYY-MM-DD HH:MM:SS` UTC format (not ISO 8601).
          - `meta` object
            - `location` string
            - `winner` boolean, nullable
            - `position` integer, nullable
        - `scores` object[]
          - `id` integer
          - `fixture_id` integer
          - `type_id` integer
          - `participant_id` integer
          - `score` object
            - `goals` integer
            - `participant` string
          - `description` string
    - `aggregates` object[]
      - `id` integer
      - `league_id` integer
      - `season_id` integer
      - `stage_id` integer
      - `name` string
      - `fixture_ids` integer[]
      - `result` string
      - `detail` string
      - `winner_participant_id` integer
      - `fixtures` object[]
        - `id` integer
        - `sport_id` integer
        - `league_id` integer
        - `season_id` integer
        - `stage_id` integer
        - `group_id` unknown
        - `aggregate_id` integer
        - `round_id` unknown
        - `state_id` integer
        - `venue_id` integer
        - `name` string
        - `starting_at` string: Timestamp in `YYYY-MM-DD HH:MM:SS` UTC format (not ISO 8601).
        - `result_info` string
        - `leg` string
        - `details` unknown
        - `length` integer
        - `placeholder` boolean
        - `has_odds` boolean
        - `has_premium_odds` boolean
        - `starting_at_timestamp` integer
        - `participants` object[]
          - `id` integer
          - `sport_id` integer
          - `country_id` integer
          - `venue_id` integer
          - `gender` string
          - `name` string
          - `short_code` string
          - `image_path` string
          - `founded` integer
          - `type` string
          - `placeholder` boolean
          - `last_played_at` string: Timestamp in `YYYY-MM-DD HH:MM:SS` UTC format (not ISO 8601).
          - `meta` object
            - `location` string
            - `winner` boolean
            - `position` integer
        - `scores` object[]
          - `id` integer
          - `fixture_id` integer
          - `type_id` integer
          - `participant_id` integer
          - `score` object
            - `goals` integer
            - `participant` string
          - `description` string
    - `fixtures` object[]
      - `id` integer
      - `sport_id` integer
      - `league_id` integer
      - `season_id` integer
      - `stage_id` integer
      - `group_id` unknown
      - `aggregate_id` unknown
      - `round_id` unknown
      - `state_id` integer
      - `venue_id` integer
      - `name` string
      - `starting_at` string: Timestamp in `YYYY-MM-DD HH:MM:SS` UTC format (not ISO 8601).
      - `result_info` string, nullable
      - `leg` string
      - `details` unknown
      - `length` integer
      - `placeholder` boolean
      - `has_odds` boolean
      - `has_premium_odds` boolean
      - `starting_at_timestamp` integer
      - `participants` object[]
        - `id` integer
        - `sport_id` integer
        - `country_id` integer
        - `venue_id` integer
        - `gender` string
        - `name` string
        - `short_code` string
        - `image_path` string
        - `founded` integer
        - `type` string
        - `placeholder` boolean
        - `last_played_at` string: Timestamp in `YYYY-MM-DD HH:MM:SS` UTC format (not ISO 8601).
        - `meta` object
          - `location` string
          - `winner` boolean, nullable
          - `position` integer, nullable
      - `scores` object[]
        - `id` integer
        - `fixture_id` integer
        - `type_id` integer
        - `participant_id` integer
        - `score` object
          - `goals` integer
          - `participant` string
        - `description` string
  - `subscription` SubscriptionInfo[]
    - `meta` SubscriptionMeta
      - `trial_ends_at` string, date-time, nullable
      - `ends_at` string, date-time, nullable
      - `current_timestamp` integer
      - `next_billing_cycle` string, nullable
    - `plans` SubscriptionPlan[]
      - `plan` string
      - `sport` string
      - `category` string
    - `add_ons` SubscriptionAddOn[]: Add-ons / trialing features for this account. Empty when none are attached.
      - `add_on` string: Add-on name; may include a trial-end suffix like ' - Trialing until 2026-05-31 13:19:52'.
      - `sport` string
      - `category` string: Add-on category (Predictions, Team rankings, Calls, …).
    - `widgets` SubscriptionWidget[]: Widget entitlements for this account. Empty when none are attached.
      - `widget` string: Widget name (e.g. 'Wesley van Rooij Widgets All').
      - `sport` string: Sport scope of the widget (e.g. 'Football').
  - `rate_limit` RateLimit: Rate-limit window metadata returned with every successful response.
    - `resets_in_seconds` integer
    - `remaining` integer
    - `requested_entity` string
  - `timezone` string, required

## Other responses

- `400`: Bad Request. Some part of the request is malformed.
- `401`: Unauthorized. The request is not authenticated (missing or invalid api_token).
- `403`: Forbidden. The endpoint or resource is not accessible from your subscription.
- `404`: Not Found. The endpoint or resource does not exist.
- `422`: Validation Error. Required parameters missing or malformed.
- `429`: Too Many Requests. Hourly request limit exceeded — see RateLimit metadata.
- `500`: Internal Server Error. An internal error has been logged for inspection.

---

[API](https://skmtc.dev/sportmonks/apis/sportmonks-football-api.md) - [All operations](https://skmtc.dev/sportmonks/apis/sportmonks-football-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sportmonks/apis/sportmonks-football-api/revisions/c9d56fb26b94?raw)