---
title: "SofaScore competition seasons"
method: GET
path: "/sofascore/tournament-seasons"
tags: ["SofaScore"]
---

# SofaScore competition seasons

`GET /sofascore/tournament-seasons`

## Request

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

Returns the season list for a competition. Use a returned season id with the standings and round-events endpoints.

## Query parameters

- `id` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- SofascoreTournamentSeasonsResponseDoc
  - `code` integer
  - `data` SofascoreTournamentSeasonsResponse
    - `count` integer: Number of seasons returned.
    - `fetched_at` string: Time the data was fetched, in UTC (RFC 3339).
    - `seasons` SofascoreSeason[]: Seasons SofaScore has for the competition.
      - `id` integer: SofaScore season id. Pass it to the standings and round endpoints.
      - `name` string: Season name.
      - `year` string: Season label, for example 26/27.
    - `source_url` string: SofaScore URL the data was read from.
    - `tournament_id` integer: Id of the competition (the unique tournament id).
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `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/0497899e2016?raw)