​
Overview

This endpoint returns the list of referees who officiated matches in a specific tournament along with aggregated statistics for their performances.

​
Typical use cases

  • Retrieve referees assigned to a tournament
  • Analyze referee statistics
  • Generate referee performance dashboards
  • Integrate referee analytics into broadcast or scouting tools
Each referee includes statistical summaries such as:
  • Matches played
  • Corners awarded
  • Offside decisions
  • Yellow / red cards issued
  • Penalties awarded
  • Fouls called
  • Average played time
GET /api.php

​
Parameters

​
module
string
Always use api
​
api
string
The API name, use TournamentRefereeList
​
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=TournamentRefereeList&version=V2&lang=en&response=json&key=YOUR_API_KEY&tournament_id=211"

​
Response

{
  "result": "string",
  "message": "string",
  "data": {
    "_type": "TOURNAMENT",
    "id": "integer",
    "tournament": "string",
    "startDate": "YYYY-MM-DD",
    "endDate": "YYYY-MM-DD",

    "referees": [
      {
        "_type": "REFEREE",
        "id": "integer",
        "name": "string",
        "dob": "YYYY-MM-DD|null",

        "stats": {
          "MatchesPlayed": "integer|null",
          "Corners": "integer|null",
          "Offside": "integer|null",
          "Yellow Card": "integer|null",
          "2nd Yellow Card": "integer|null",
          "Direct Red Card": "integer|null",
          "Penalties": "integer|null",
          "Fouls": "integer|null",
          "Fouls In Final Third": "integer|null",
          "Average Played Time in Minute": "integer"
        }
      }
    ]
  }
}