---
title: "Flashscore competition seasons by stage id"
method: GET
path: "/flashscore/tournament-archive-seasons"
tags: ["Flashscore"]
---

# Flashscore competition seasons by stage id

`GET /flashscore/tournament-archive-seasons`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/flashscore/tournament-archive-seasons`
- Auth: API key in header `x-api-key`

Returns every season of the competition that owns a tournament stage: season label, season tournament id, whether it is current, the winning participants and the stage ids of each season, plus the requested stage's names and page tabs (summary, odds, standings, results, fixtures, draw, news). Get a stage id from tournament_stage_id in the competition block of team, player and match event lists, then reuse the stage ids returned here for older seasons. Pass a stage id, not a season tournament id or a competition id: other ids can return an unrelated competition, so check the returned tournament name. An unknown stage id returns not found.

## Query parameters

- `stage_id` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- object: The Response struct is used for wrapping the API response with a code, message, and data.
  - `code` integer: Code is the HTTP status code or a custom code used to indicate the result of the request @example 200
  - `data` object: Data is the response data (can be any object or null) @example {"id": 1, "name": "John Doe"}
    - `league_key` string
    - `season_count` integer
    - `seasons` FlashscoreArchiveSeason[]
      - `end_year` string
      - `is_current` boolean
      - `is_requested` boolean
      - `season` string
      - `stage_ids` string[]
      - `start_year` string
      - `tournament_id` string: TournamentID is the season-level tournament id (the tournament_id of event competition blocks), accepted by flashscore-tournament-outright-odds.
      - `winners` FlashscoreArchiveWinner[]
        - `id` string
        - `name` string
        - `slug` string
    - `source_url` string
    - `stage` FlashscoreArchiveStage
      - `country` string
      - `end_estimated` string
      - `group` string
      - `id` string
      - `is_final` boolean
      - `name` string
      - `start_estimated` string
      - `tabs` FlashscoreArchiveTab[]
        - `id` 'SU' | 'OD' | 'TA' | 'RE' | 'FI' | 'DR' | 'NF'
        - `name` string
      - `tournament` string
      - `type_id` integer
    - `stage_id` string
    - `tournament_template_id` string
  - `msg` unknown

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/028417aa35bb?raw)