Skip to main content
GET
/
TournamentRefereeList
Tournament Referee List
curl --request GET \
  --url 'https://api.example.com/TournamentRefereeList?key='
{
  "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"
        }
      }
    ]
  }
}

​
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 "{{Base URL}}?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"
        }
      }
    ]
  }
}

Authorizations

​
key
string
query
required

API key passed as a query parameter named key.

Query Parameters

​
module
string
default:api

Module API fixed and cannot be changed

​
version
string
default:V2

The API version

​
response
string
default:json

The response returned by the API. The value of this field could be "json" or "xml"

​
lang
string
default:en

The language is english by default, pass "ar" to return the values in Arabic language.

​
tournament_id
integer
required

The tournament ID can be retrieve from the TournamentList API.

Response

Successful response

The response is of type object.