​
List Players V2

The EntityPlayers endpoint returns a paginated list of players. The endpoint supports search filters, pagination, and incremental synchronization using the since parameter. Each player record includes:
  • Player identity
  • Nationality
  • Date of birth and age
  • Primary and secondary positions
  • Current team
  • Gender
  • Player image
  • Retirement status

​
Typical use cases

  • Build searchable player databases
  • Synchronize players with external systems
  • Retrieve players for scouting platforms
  • Load paginated player lists in dashboards
GET /api.php

​
Parameters

​
module
string
Always use api.
​
api
string
Always use EntityPlayers.
​
version
string
API version. Always use V2.
​
response
string
Response format. Always use json.
​
lang
string
Language of the response. Example: en.
​
tournaments
string
Comma-separated list of tournament IDs used to filter players participating in specific tournaments.
​
seasons
string
Comma-separated list of season IDs used to filter players participating in specific seasons.
​
team_id
integer
Filter players belonging to a specific team.
​
country_id
integer
Filter players by nationality country ID.
​
name
string
Search players by English or Arabic full name or nickname.
​
since
datetime
Returns only players updated on or after the specified date and time.Format: YYYY-MM-DD HH:MM:SS
​
page_size
integer
Number of players returned per page. Maximum value is 500. Default is 100.
​
page_number
integer
Page number of the results to retrieve. Default is 1.

​
Since Parameter

The since parameter allows incremental synchronization. Only players updated after the provided timestamp will be returned. Format requirements:
  • YYYY-MM-DD HH:MM:SS
  • Local time
  • Example: since=2024-04-20 20:39:35
Date components:
ComponentFormatExample
Year4 digits2024
Month2 digits01–12
Day2 digits01–31
Hour2 digits00–23
Minutes2 digits00–59
Seconds2 digits00–59

​
Pagination

The endpoint supports standard pagination.
ParameterDescription
page_sizeNumber of records returned per request
page_numberPage index of the results
Example: page_size=100 page_number=1

​
Example Request

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

{
    "result": true,
    "title": "success",
    "message": "We found 14 player(s) updated since 2025-07-06 19:59:00",
    "object": {
        "total_records": 14,
        "current_records": 3,
        "pages": 5,
        "current_page": 1,
        "Data": [
            {
                "_type": "PLAYER",
                "id": 274065,
                "fullname": "Anta Dembélé",
                "nickname": "Anta Dembélé",
                "nationality": {
                    "id": 161,
                    "name": "Senegal"
                },
                "dob": "1994-06-15",
                "age": "32 Y",
                "positions": {
                    "primary": {
                        "id": 3,
                        "name": "CB"
                    },
                    "secondary": {
                        "id": 3,
                        "name": "CB"
                    }
                },
                "retired": false,
                "current_team": {
                    "id": 23247,
                    "name": "Senegal"
                },
                "gender": "FEMALE",
                "image": "https://korastats.sirv.com/root/players/274065.png",
                "last_updated": "2025-07-06 20:03:17"
            },
            {
                "_type": "PLAYER",
                "id": 274069,
                "fullname": "Bineta Korkel Seck",
                "nickname": "Bineta Korkel Seck",
                "nationality": {
                    "id": 161,
                    "name": "Senegal"
                },
                "dob": "1998-01-11",
                "age": "28 Y",
                "positions": {
                    "primary": {
                        "id": 7,
                        "name": "CM"
                    },
                    "secondary": {
                        "id": 6,
                        "name": "DM"
                    }
                },
                "retired": false,
                "current_team": {
                    "id": 23247,
                    "name": "Senegal"
                },
                "gender": "FEMALE",
                "image": "https://korastats.sirv.com/root/players/274069.png",
                "last_updated": "2025-07-06 19:59:19"
            },
            {
                "_type": "PLAYER",
                "id": 439467,
                "fullname": "Dieynaba Ndaw",
                "nickname": "Dieynaba Ndaw",
                "nationality": {
                    "id": 161,
                    "name": "Senegal"
                },
                "dob": "2003-04-10",
                "age": "23 Y",
                "positions": {
                    "primary": {
                        "id": 8,
                        "name": "AM"
                    },
                    "secondary": {
                        "id": 11,
                        "name": "SS"
                    }
                },
                "retired": false,
                "current_team": {
                    "id": 23247,
                    "name": "Senegal"
                },
                "gender": "FEMALE",
                "image": "https://korastats.sirv.com/root/players/439467.png",
                "last_updated": "2025-07-06 20:01:32"
            }
        ]
    }
}