​
Overview

The List Seasons endpoint retrieves a paginated list of seasons available in the system. Each season represents a specific edition of a tournament within a defined time period and includes metadata about the tournament, organizer, and age group. The endpoint supports incremental synchronization through the since parameter, allowing developers to retrieve only the seasons that were updated after a specified date and time. This is useful for keeping external systems synchronized with the latest season data without repeatedly downloading the entire dataset. The response includes season details such as the season name, start and end dates, gender category, tournament information, organizer information, and associated age group. This endpoint should typically be used when:
  • Synchronizing season metadata between systems
  • Building tournament browsers or competition lists
  • Preparing data pipelines that depend on season structures
  • Periodically updating cached season data

​
Typical Use Cases

  • Synchronizing seasons into a local database.
  • Displaying available competitions in an application.
  • Building dashboards for tournaments and seasons.
  • Updating season data using incremental updates with the since parameter.

​
Parameters

​
module
string
Module API is fixed and cannot be changed. Always use api.
​
api
string
Defines the API endpoint to execute. For this endpoint use SeasonList.
​
version
string
Specifies the API version. The supported version for this endpoint is V2.
​
response
string
Specifies the response format. Use json.
​
lang
string
Language of the response. Example: en.
​
since
datetime
Optional parameter used to retrieve seasons that were updated after a specific date and time. Format: “YYYY-MM-DD HH:MM:SS” Example: “2023-01-15 12:30:00”
​
page_number
integer
Specifies which page of results should be returned.
​
page_size
integer
Defines the number of records returned per page.

​
Endpoint

GET api.php

​
Code Examples

curl "https://korastats.pro/pro/api.php?module=api&api=SeasonList&version=V2&response=json&lang=en&page_number=1&page_size=100"

​
Response Example

{
  "root": {
    "result": true,
    "title": "success",
    "message": "We found 1 Seasons",
    "object": {
      "total_records": 1,
      "current_records": 1,
      "pages": 1,
      "current_page": 1,
      "Data": [
        {
          "_type": "SEASON",
          "name": "World Cup Qatar 2022",
          "gender": null,
          "nature": "HYPRID",
          "tournament": {
            "id": 39,
            "name": "FIFA World Cup",
            "gender": "MALE",
            "organizer": {
              "id": 1,
              "name": "International Federation of Football Association"
            },
            "age_group": {
              "id": 19,
              "name": "Adult"
            }
          },
          "startDate": "2022-11-20",
          "endDate": "2022-12-18"
        }
      ]
    }
  }
}

​
Response Fields

FieldTypeDescription
resultbooleanIndicates whether the request was successful.
titlestringStatus title of the response.
messagestringHuman-readable message describing the result.
object.total_recordsintegerTotal number of records available in the dataset.
object.current_recordsintegerNumber of records returned in the current response.
object.pagesintegerTotal number of pages available.
object.current_pageintegerThe current page number returned by the API.
DataarrayList of season objects returned by the API.
Data._typestringObject type identifier.
Data.namestringName of the season.
Data.genderstringGender category for the season if defined.
Data.naturestringDefines the season structure type (e.g., HYBRID).
Data.tournament.idintegerUnique identifier of the tournament.
Data.tournament.namestringName of the tournament associated with the season.
Data.tournament.genderstringGender classification of the tournament.
Data.tournament.organizer.idintegerUnique identifier of the organizing body.
Data.tournament.organizer.namestringName of the organization managing the tournament.
Data.tournament.age_group.idintegerUnique identifier of the age group category.
Data.tournament.age_group.namestringName of the age group (e.g., Adult).
Data.startDatedateStart date of the season.
Data.endDatedateEnd date of the season.