​
Overview

This endpoint returns the complete structure of a football season. The response includes:
  • Tournament information
  • Season metadata
  • Competition stages
  • Groups within each stage
  • Teams and standings within groups
Depending on the parameters used, the response can also include:
  • Teams participating in the competition
  • Matches within each stage
This endpoint is useful for retrieving the full competition hierarchy of a tournament season.

​
Typical use cases

  • Build competition trees
  • Display tournament brackets
  • Show league tables and group standings
  • Synchronize competition structures
  • Create tournament navigation in applications
Each season record includes:
  • season information
  • tournament details
  • organizer
  • age group
  • competition stages
  • groups and standings
GET /api.php

​
Parameters

​
module
string
Module API fixed and cannot be changed. Always use api.
​
api
string
Endpoint name. Use SeasonStructure.
​
version
string
API version. Use V2.
​
season_id
integer
Unique identifier of the season.
​
include_teams
integer
Include teams and standings in the response.1 = include teams
0 = exclude teams
​
include_matches
integer
Include match information in the response.1 = include matches
0 = exclude matches
​
lang
string
Language of returned text.en = English
ar = Arabic
​
response
string
Output format (json or xml).
​
key
string
API authentication key.

​
Example Request

curl --request GET \
  --url "https://korastats.pro/pro/api.php?module=api&api=SeasonStructure&version=V2&season_id=444&include_teams=1&include_matches=0&lang=en&response=json&key=YOUR_API_KEY"

​
Example Response

{
  "result": "Success",
  "message": "6 stages retrieved.",
  "data": {
    "_type": "SEASON",
    "id": 444,
    "tournament": {
      "id": 39,
      "name": "FIFA World Cup"
    },
    "season": "World Cup Qatar 2022",
    "startDate": "2022-11-20",
    "endDate": "2022-12-18",
    "gender": "MALE",
    "age": {
      "id": 19,
      "name": "Adult"
    },
    "organizer": {
      "id": 1,
      "name": "International Federation of Football Association",
      "country": {
        "id": null,
        "name": null
      }
    },
    "stages": [
      {
        "_type": "STAGE",
        "id": 751,
        "stage": "Group Stage",
        "order": 1,
        "rounds": 1,
        "type": "League",
        "groups": [
          {
            "_type": "GROUP",
            "id": 1105,
            "group": "Group A",
            "teams": [
              {
                "_type": "TEAM",
                "id": 86,
                "team": "Netherlands",
                "matches": 3,
                "points": 7,
                "goals_scored": 5,
                "goals_conceded": 1,
                "goals_difference": 4,
                "won": 2,
                "draw": 1,
                "lost": 0,
                "goals_scored_home": 3,
                "goals_conceded_home": 1,
                "goals_difference_home": 2,
                "goals_scored_away": 2,
                "goals_conceded_away": 0,
                "goals_difference_away": 2,
                "lastupdate": "2023-08-07 16:02:06"
              }
            ]
          }
        ]
      },
      {
        "_type": "STAGE",
        "id": 763,
        "stage": "Round Of 16",
        "order": 2,
        "rounds": 1,
        "type": "Knockout",
        "groups": [
          {
            "_type": "GROUP",
            "id": 1125,
            "group": "Round Of 16",
            "teams": [
              {
                "_type": "TEAM",
                "id": 40,
                "team": "Brazil",
                "matches": 1,
                "points": null,
                "goals_scored": null,
                "goals_conceded": null,
                "goals_difference": null,
                "won": 1,
                "draw": null,
                "lost": 0,
                "lastupdate": "2023-08-07 16:02:06"
              }
            ]
          }
        ]
      },
      {
        "_type": "STAGE",
        "id": 769,
        "stage": "Final",
        "order": 6,
        "rounds": 1,
        "type": "Knockout",
        "groups": [
          {
            "_type": "GROUP",
            "id": 1137,
            "group": "Final",
            "teams": [
              {
                "_type": "TEAM",
                "id": 135,
                "team": "Argentina",
                "matches": 1,
                "points": null,
                "goals_scored": null,
                "goals_conceded": null,
                "goals_difference": null,
                "won": 0,
                "draw": null,
                "lost": 1,
                "lastupdate": "2023-08-07 16:02:07"
              }
            ]
          }
        ]
      }
    ]
  }
}

​
Response Structure

​
Season Information

FieldDescription
idUnique season identifier
seasonSeason name
startDateSeason start date
endDateSeason end date
genderCompetition gender category
ageAge group of the competition

​
Tournament Information

FieldDescription
tournament.idTournament identifier
tournament.nameTournament name

​
Organizer Information

FieldDescription
organizer.idOrganizer identifier
organizer.nameOrganizer name
organizer.countryOrganizer country

​
Stages

Each season contains multiple competition stages. Examples include:
  • Group Stage
  • Round Of 16
  • Quarter Final
  • Semi Final
  • Final
FieldDescription
idStage identifier
stageStage name
orderStage order within the season
roundsNumber of rounds
typeCompetition type (League or Knockout)

​
Groups

Stages may contain groups.
FieldDescription
idGroup identifier
groupGroup name
Examples include:
  • Group A
  • Group B
  • Quarter Final
  • Final

​
Team Standings

Each group contains teams and their statistics.
FieldDescription
idTeam identifier
teamTeam name
matchesMatches played
pointsPoints earned
goals_scoredGoals scored
goals_concededGoals conceded
goals_differenceGoal difference
wonMatches won
drawMatches drawn
lostMatches lost
Additional home and away statistics may also be included in the response.