​
Overview

This endpoint returns the official match squad for both teams in a specific match. The response includes:
  • Match summary information
  • Tournament and season details
  • Stadium information
  • Home team squad
  • Away team squad
  • Player lineup status
  • Bench players
Each team squad contains detailed player information including:
  • player identity
  • shirt number
  • position
  • lineup status
  • bench status
This endpoint is commonly used for:
  • Match lineup displays
  • Match center applications
  • Broadcast graphics
  • Squad analysis tools
  • Live match dashboards
GET /api.php

​
Parameters

​
module
string
Module API fixed and cannot be changed. Always use api.
​
api
string
Endpoint name. Use MatchSquad.
​
version
string
API version. Use V2.
​
platform_id
integer
Identifier of the data provider platform.
​
platform_match_id
string
External platform match identifier.
​
match_id
integer
Optional internal KoraStats match identifier.
​
lang
string
Language of the response.en = English
ar = Arabic
​
response
string
Output format (json or xml).
​
key
string
API authentication key.

​
Example Request

curl --request GET \
  --url "https://korastats.pro/pro/api.php?module=api&api=MatchSquad&version=V2&platform_id=1&platform_match_id=6647ef81220cabadd799c51b&lang=en&response=json&key=YOUR_API_KEY"

​
Response Structure

​
Match Summary

FieldDescription
matchIdUnique match identifier
tournamentTournament name
seasonSeason name
roundRound number
dateTimeMatch date and kickoff time
lastUpdateDateTimeLast data update timestamp

​
Stadium Information

FieldDescription
stadium.idStadium identifier
stadium.nameStadium name

​
Team Information

Each match includes two teams:
  • Home team
  • Away team
FieldDescription
team.idTeam identifier
team.nameTeam name

​
Player Squad

Each team contains a squad list of players.
FieldDescription
idPlayer identifier
namePlayer full name
nick_namePlayer display name
shirt_numberPlayer shirt number

​
Player Position

FieldDescription
position.idPosition identifier
position.nameTactical position
Examples include:
  • GK — Goalkeeper
  • CB — Center Back
  • RB — Right Back
  • LB — Left Back
  • CM — Central Midfielder
  • AM — Attacking Midfielder
  • RW — Right Winger
  • LW — Left Winger
  • CF — Center Forward

​
Squad Status

FieldDescription
lineupIndicates whether the player is in the starting lineup
benchIndicates whether the player is on the bench
Possible values:
  • true
  • false
{
  "MatchSquadResponse": {
    "type": "object",
    "properties": {
      "result": {
        "type": "string",
        "example": "Success"
      },
      "message": {
        "type": "string",
        "example": "Squad Retrieved"
      },
      "data": {
        "type": "array",
        "items": {
          "$ref": "#/components/schemas/MatchSquad"
        }
      }
    }
  },

  "MatchSquad": {
    "type": "object",
    "properties": {
      "_type": {
        "type": "string",
        "example": "MATCH SUMMARY"
      },
      "matchId": {
        "type": "integer",
        "example": 10001
      },
      "tournament": {
        "type": "string",
        "example": "Example Tournament"
      },
      "season": {
        "type": "string",
        "example": "2024/2025"
      },
      "dateTime": {
        "type": "string",
        "format": "date-time",
        "example": "2024-01-01 18:00:00"
      },
      "stadium": {
        "$ref": "#/components/schemas/Stadium"
      },
      "home": {
        "$ref": "#/components/schemas/MatchTeamSquad"
      },
      "away": {
        "$ref": "#/components/schemas/MatchTeamSquad"
      }
    }
  },

  "Stadium": {
    "type": "object",
    "properties": {
      "id": {
        "type": "integer",
        "example": 500
      },
      "name": {
        "type": "string",
        "example": "Example Stadium"
      }
    }
  },

  "MatchTeamSquad": {
    "type": "object",
    "properties": {
      "team": {
        "$ref": "#/components/schemas/Team"
      },
      "squad": {
        "type": "array",
        "items": {
          "$ref": "#/components/schemas/PlayerSquad"
        }
      }
    }
  },

  "Team": {
    "type": "object",
    "properties": {
      "id": {
        "type": "integer",
        "example": 200
      },
      "name": {
        "type": "string",
        "example": "Example Team"
      }
    }
  },

  "PlayerSquad": {
    "type": "object",
    "properties": {
      "id": {
        "type": "integer",
        "example": 3001
      },
      "name": {
        "type": "string",
        "example": "Example Player"
      },
      "shirt_number": {
        "type": "integer",
        "example": 10
      },
      "position": {
        "$ref": "#/components/schemas/PlayerPosition"
      },
      "lineup": {
        "type": "boolean",
        "example": true
      },
      "bench": {
        "type": "boolean",
        "example": false
      }
    }
  },

  "PlayerPosition": {
    "type": "object",
    "properties": {
      "name": {
        "type": "string",
        "example": "FW"
      }
    }
  }
}