Overview

The EntityReferee endpoint returns detailed information about a specific referee stored in the KoraStats database. The response includes:
  • Referee full name
  • Nationality
  • Date of birth
  • Calculated age
  • Gender
  • Retirement status
  • Referee profile image
This endpoint is typically used for:
  • Referee profile pages
  • Competition officiating records
  • Administrative referee directories
  • Data synchronization with external systems
GET /api.php

Parameters

module
string
Always use api
api
string
Always use EntityReferee
version
string
API version. Example: V2
response
string
Response format. Always use json
lang
string
Language of the response. Example: en
referee_id
integer
required
Unique identifier of the referee.

Example Request

curl --request GET \
--url "https://korastats.pro/pro/api.php?module=api&api=EntityReferee&version=V2&response=json&lang=en&referee_id=5"
{
  "type": "object",
  "properties": {
    "root": {
      "type": "object",
      "properties": {
        "result": {
          "type": "boolean",
          "description": "Indicates whether the request was successful."
        },
        "title": {
          "type": "string",
          "description": "Response title."
        },
        "message": {
          "type": "string",
          "description": "Human-readable response message."
        },
        "object": {
          "type": "object",
          "properties": {
            "_type": {
              "type": "string",
              "description": "Object type identifier."
            },
            "id": {
              "type": "integer",
              "description": "Referee ID."
            },
            "fullname": {
              "type": "string",
              "description": "Full name of the referee."
            },
            "nationality": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "integer",
                  "description": "Country ID."
                },
                "name": {
                  "type": "string",
                  "description": "Country name."
                }
              }
            },
            "dob": {
              "type": "string",
              "format": "date",
              "description": "Referee date of birth."
            },
            "age": {
              "type": "string",
              "description": "Calculated referee age."
            },
            "retired": {
              "type": "boolean",
              "description": "Indicates whether the referee is retired."
            },
            "gender": {
              "type": "string",
              "description": "Referee gender."
            },
            "image": {
              "type": "string",
              "description": "URL of the referee profile image."
            }
          }
        }
      }
    }
  }
}