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

# SofaScore competition info

`GET /sofascore/tournament-info`

## Request

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

Returns a competition's metadata (name, sport, category, tier, title holder, most titles, current season dates, divisions above and below, linked competitions). When `season` is given it also returns that season's aggregates: number of competitors and, for football competitions, goals, home wins, away wins, draws, yellow and red cards and the promoted teams. Get `id` from search and `season` from tournament-seasons.

## Query parameters

- `id` string, required
- `season` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- SofascoreTournamentInfoResponseDoc
  - `code` integer
  - `data` SofascoreTournamentInfoResponse
    - `fetched_at` string
    - `season` SofascoreSeasonInfo
      - `away_team_wins` integer
      - `draws` integer
      - `goals` integer
      - `home_team_wins` integer
      - `id` integer
      - `name` string
      - `newcomers_lower_division` SofascoreTeamRef[]
        - `country` string: Country the team belongs to.
        - `id` integer: SofaScore team id. Use it with the team endpoints.
        - `name` string: Full team name.
        - `national` boolean: True for a national team.
        - `short_name` string: Shortened team name.
        - `slug` string: URL slug of the team on SofaScore.
      - `newcomers_other` SofascoreTeamRef[]
        - `country` string: Country the team belongs to.
        - `id` integer: SofaScore team id. Use it with the team endpoints.
        - `name` string: Full team name.
        - `national` boolean: True for a national team.
        - `short_name` string: Shortened team name.
        - `slug` string: URL slug of the team on SofaScore.
      - `newcomers_upper_division` SofascoreTeamRef[]
        - `country` string: Country the team belongs to.
        - `id` integer: SofaScore team id. Use it with the team endpoints.
        - `name` string: Full team name.
        - `national` boolean: True for a national team.
        - `short_name` string: Shortened team name.
        - `slug` string: URL slug of the team on SofaScore.
      - `number_of_competitors` integer
      - `red_cards` integer
      - `year` string
      - `yellow_cards` integer
    - `season_id` integer
    - `season_source_url` string
    - `source_url` string
    - `tournament` SofascoreTournamentDetail
      - `category` string
      - `current_season_end` string
      - `current_season_start` string
      - `gender` string
      - `has_groups` boolean
      - `has_playoff_series` boolean
      - `has_rounds` boolean
      - `id` integer
      - `linked_tournaments` SofascoreCompetitionRef[]
        - `id` integer
        - `name` string
        - `slug` string
      - `lower_divisions` SofascoreCompetitionRef[]
        - `id` integer
        - `name` string
        - `slug` string
      - `most_titles` integer
      - `most_titles_teams` SofascoreTeamRef[]
        - `country` string: Country the team belongs to.
        - `id` integer: SofaScore team id. Use it with the team endpoints.
        - `name` string: Full team name.
        - `national` boolean: True for a national team.
        - `short_name` string: Shortened team name.
        - `slug` string: URL slug of the team on SofaScore.
      - `name` string
      - `slug` string
      - `sport` string
      - `tier` integer
      - `title_holder` SofascoreTeamRef
        - `country` string: Country the team belongs to.
        - `id` integer: SofaScore team id. Use it with the team endpoints.
        - `name` string: Full team name.
        - `national` boolean: True for a national team.
        - `short_name` string: Shortened team name.
        - `slug` string: URL slug of the team on SofaScore.
      - `title_holder_titles` integer
      - `upper_divisions` SofascoreCompetitionRef[]
        - `id` integer
        - `name` string
        - `slug` string
    - `tournament_id` integer
  - `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/afac9b012a27?raw)