Overview

This endpoint returns all matches for a given tournament. Each match includes:
  • Match identifiers and competition context (tournament, season, round)
  • Home and away teams
  • Match datetime + last update datetime
  • Stadium
  • Match officials (referee, assistants)
  • Final score (if available)

Typical use cases:

  • Build fixture/results lists
  • Load matches for analytics pipelines
  • Power match selector UIs
  • Generate competition calendars
GET /api.php

Parameters

module
string
Always use api
api
string
The API name, use TournamentMatchList
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
tournament_id
string
The tournament ID (example: 211)

Example Request

curl --request GET \
  --url "https://korastats.pro/pro/api.php?module=api&api=TournamentMatchList&version=V2&lang=en&response=json&key=YOUR_API_KEY&tournament_id=211"

Response

{
  "result": "string",
  "message": "string",
  "data": [
    {
      "_type": "MATCH",
      "matchId": "integer",
      "tournament": "string",
      "season": "string",
      "round": "integer|null",

      "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": "string",
        "id": "integer",
        "name": "string",
        "dob": "YYYY-MM-DD|null",
        "gender": "string|null",
        "nationality": "object|null"
      },

      "assistant2": {
        "_type": "string",
        "id": "integer",
        "name": "string",
        "dob": "YYYY-MM-DD|null",
        "gender": "string|null",
        "nationality": "object|null"
      },

      "score": {
        "home": "integer|null",
        "away": "integer|null"
      }
    }
  ]
}