​
Overview

The EntityCoaches endpoint retrieves a paginated list of coaches stored in the KoraStats database. The endpoint allows applications to search and filter coaches using several criteria including season participation, nationality, name, and update time. The response includes:
  • Coach ID
  • Full name
  • Nationality
  • Date of birth
  • Calculated age
  • Gender
  • Retirement status
  • Coach profile image
Typical use cases include:
  • Building coach directories
  • Synchronizing coaching staff databases
  • Filtering coaches involved in specific seasons
  • Searching coaches by name or nationality
GET /api.php

​
Parameters

​
module
string
Always use api
​
api
string
Always use EntityCoaches
​
version
string
API version. Example: V2
​
response
string
Response format. Always use json
​
lang
string
Language of the response. Example: en
​
page_size
integer
Number of records returned per page.
​
page_number
integer
Page index of the results.
​
seasons
string
Comma-separated list of season identifiers to filter coaches who participated in those seasons.Example:seasons=444,445
​
name
string
Search coaches by name.Example:name=Martinez
​
country_id
integer
Filter coaches by nationality.
​
since
datetime
Returns coaches updated after the specified date and time.Format:YYYY-MM-DD HH:MM:SSExample:since=2023-01-15 12:30:00

​
Date Format Requirements

The since parameter must follow the exact datetime format: YYYY-MM-DD HH:MM:SS Guidelines:
  • Year: four digits (e.g., 2023)
  • Month: two digits (01 to 12)
  • Day: two digits (01 to 31)
  • Hour: two digits (00 to 23)
  • Minutes: two digits (00 to 59)
  • Seconds: two digits (00 to 59)
Example: since=2023-01-15 12:30:00 The date and time must be provided in local server time.

​
Pagination

Pagination allows retrieving large datasets efficiently.
ParameterDescription
page_sizeNumber of coaches returned in each request
page_numberSpecifies which page of results to retrieve

​
Example Request

curl --request GET \
--url "https://korastats.pro/pro/api.php?module=api&api=EntityCoaches&version=V2&response=json&lang=en&page_size=100&page_number=1&seasons=444"

{
  "type": "object",
  "properties": {
    "root": {
      "type": "object",
      "properties": {
        "result": {
          "type": "boolean"
        },
        "title": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "object": {
          "type": "object",
          "properties": {
            "total_records": {
              "type": "integer",
              "description": "Total number of coaches matching the filters."
            },
            "current_records": {
              "type": "integer",
              "description": "Number of coaches returned in this request."
            },
            "pages": {
              "type": "integer",
              "description": "Total number of pages available."
            },
            "current_page": {
              "type": "integer",
              "description": "Current page number."
            },
            "Data": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "_type": {
                    "type": "string"
                  },
                  "id": {
                    "type": "integer"
                  },
                  "fullname": {
                    "type": "string"
                  },
                  "nationality": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "integer"
                      },
                      "name": {
                        "type": "string"
                      }
                    }
                  },
                  "dob": {
                    "type": "string",
                    "nullable": true
                  },
                  "age": {
                    "type": "string",
                    "nullable": true
                  },
                  "retired": {
                    "type": "boolean"
                  },
                  "gender": {
                    "type": "string"
                  },
                  "image": {
                    "type": "string",
                    "description": "URL of the coach profile image."
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}