​
Overview

This endpoint returns the list of matches belonging to a specific season. Each match includes full metadata such as:
  • tournament name
  • season name
  • round number
  • home and away teams
  • match date and time
  • stadium
  • referee team
  • score
  • last update timestamp
The endpoint also supports incremental synchronization using the since parameter and pagination using page_number and page_size.

​
Typical use cases

  • Retrieve season fixtures
  • Build match schedule pages
  • Synchronize match databases
  • Feed analytics pipelines
  • Build competition dashboards
Each match record contains:
  • match identifiers
  • participating teams
  • referee team
  • stadium information
  • score
GET /api.php

​
Parameters

​
module
string
Always use api
​
api
string
The API name, use SeasonMatchList
​
version
string
The API version (use V2)
​
lang
string
en for English, ar for Arabic
​
response
string
Output format (json or xml)
​
key
string
Your API key
​
season_id
string
The season ID (example: 809)
​
since
string
Optional date filter to retrieve matches updated since the given datetime (YYYY-MM-DD)
​
page_number
integer
Page number for pagination (example: 1)
​
page_size
integer
Number of records per page (example: 20)

​
Example Request

curl --request GET \
  --url "https://korastats.pro/pro/api.php?module=api&api=SeasonMatchList&version=V2&lang=en&response=json&key=YOUR_API_KEY&season_id=809&since=2022-12-03&page_number=1&page_size=20"

{
  "result": "string",
  "message": "string",
  "data": [
    {
      "_type": "MATCH",
      "matchId": "integer",
      "tournament": "string",
      "season": "string",
      "round": "integer",
      "home": {
        "_type": "TEAM",
        "id": "integer",
        "name": "string"
      },
      "away": {
        "_type": "TEAM",
        "id": "integer",
        "name": "string"
      },
      "dateTime": "YYYY-MM-DD HH:MM:SS",
      "dtLastUpdateDateTime": "YYYY-MM-DD HH:MM:SS",
      "stadium": {
        "_type": "STADIUM",
        "id": "integer",
        "name": "string"
      },
      "referee": {
        "_type": "REFEREE",
        "id": "integer",
        "name": "string",
        "dob": "YYYY-MM-DD | null",
        "nationality": {
          "_type": "NATIONALITY",
          "id": "integer",
          "name": "string"
        }
      },
      "assistant1": {
        "_type": "ASSISTANT RFFEREE",
        "id": "integer",
        "name": "string",
        "dob": "YYYY-MM-DD | null",
        "gender": "string",
        "nationality": {
          "_type": "NATIONALITY",
          "id": "integer",
          "name": "string"
        }
      },
      "assistant2": {
        "_type": "ASSISTANT RFFEREE",
        "id": "integer",
        "name": "string",
        "dob": "YYYY-MM-DD | null",
        "gender": "string",
        "nationality": {
          "_type": "NATIONALITY",
          "id": "integer",
          "name": "string"
        }
      },
      "score": {
        "home": "integer",
        "away": "integer"
      }
    }
  ]
}