Overview

The MatchSquad endpoint returns the complete squad information for a specific match. This includes:
  • Match metadata (tournament, season, round, date)
  • Stadium information
  • Referee team
  • Home team squad
  • Away team squad
  • Player lineup and bench status
  • Player positions and shirt numbers
This endpoint is commonly used for:
  • Match lineup displays
  • Match preview or summary pages
  • Tactical analysis tools
  • Broadcast graphics preparation
Each team squad includes:
  • Player ID
  • Player name and nickname
  • Shirt number
  • Position
  • Lineup status
  • Bench status
GET /api.php

Parameters

module
string
Always use api
api
string
The API name, use MatchSquad
version
string
API version (use V2)
response
string
Output format (json or xml)
lang
string
Language of returned text (en or ar)
match_id
integer
The unique identifier of the match
key
string
API authentication key

Example Request

curl --request GET \
--url "https://korastats.pro/pro/api.php?module=api&api=MatchSquad&version=V2&response=json&lang=en&match_id=15209&key=YOUR_API_KEY"
{
  "result": "string",
  "message": "string",
  "data": [
    {
      "_type": "MATCH SUMMARY",
      "matchId": "integer",
      "tournament_id": "integer",
      "tournament": "string",
      "season_id": "integer",
      "season": "string",
      "round": "integer",
      "dateTime": "YYYY-MM-DD HH:MM:SS",
      "lastUpdateDateTime": "YYYY-MM-DD HH:MM:SS",
      "stadium": {
        "_type": "STADIUM",
        "id": "integer",
        "name": "string"
      },
      "referee": {
        "_type": "REFEREE",
        "id": "integer",
        "name": "string",
        "dob": "date | null",
        "nationality": {
          "_type": "NATIONALITY",
          "id": "integer",
          "name": "string"
        }
      },
      "assistant1": {
        "_type": "ASSISTANT REFEREE",
        "id": "integer",
        "name": "string",
        "nationality": {
          "id": "integer",
          "name": "string"
        }
      },
      "assistant2": {
        "_type": "ASSISTANT REFEREE",
        "id": "integer",
        "name": "string",
        "nationality": {
          "id": "integer",
          "name": "string"
        }
      },
      "home": {
        "_type": "TEAM",
        "team": {
          "id": "integer",
          "name": "string"
        },
        "squad": [
          {
            "_type": "PLAYER",
            "id": "integer",
            "name": "string",
            "nick_name": "string",
            "shirt_number": "integer",
            "position": {
              "_type": "POSITION",
              "id": "integer",
              "name": "string"
            },
            "lineup": "boolean",
            "bench": "boolean"
          }
        ]
      },
      "away": {
        "_type": "TEAM",
        "team": {
          "id": "integer",
          "name": "string"
        },
        "squad": [
          {
            "_type": "PLAYER",
            "id": "integer",
            "name": "string",
            "nick_name": "string",
            "shirt_number": "integer",
            "position": {
              "id": "integer",
              "name": "string"
            },
            "lineup": "boolean",
            "bench": "boolean"
          }
        ]
      },
      "status": {
        "id": "integer",
        "status": "string"
      }
    }
  ]
}