​
Overview

This endpoint returns a chronological list of match events recorded during a match. Each event contains detailed information about:
  • event time
  • team and player involved
  • event category
  • event result
  • pitch location
  • additional contextual data
Events are returned since a specific timestamp, allowing clients to retrieve only new events after the last synchronization.

​
Typical use cases

  • Live match tracking systems
  • Broadcast graphics engines
  • Match event timelines
  • Tactical and performance analysis
  • Data synchronization between systems
Each event record includes:
  • match time (half, minute, second)
  • player and team information
  • event type (pass, shot, tackle, etc.)
  • result of the action
  • pitch coordinates
  • unique event identifiers
GET /api.php

​
Parameters

​
module
string
Module API fixed and cannot be changed. Always use api.
​
api
string
Endpoint name. Use MatchEventList.
​
version
string
API version. Use V2.
​
lang
string
Language of textual fields. Use en for English or ar for Arabic.
​
match_id
integer
Unique identifier of the match.
​
since
string
Timestamp used to retrieve only events recorded after this time. Format example: 2024-03-09 06:31:02
​
response
string
Output format (json or xml).
​
key
string
API authentication key.
curl --request GET \
  --url "https://korastats.pro/pro/api.php?module=api&api=MatchEventList&version=V2&lang=en&match_id=25997&since=2024-03-09%2006:31:02&response=json&key=YOUR_API_KEY"

​
Response Structure

​
Match Information

FieldDescription
resultAPI request result
messageHuman readable message describing the response
data.matchMatch information container

​
Team Information

Each match includes home and away teams, along with their lineups.
FieldDescription
idTeam identifier
nameTeam name
logoTeam logo URL
lineupStarting lineup players
subSubstitute players

​
Player Information

Each player object contains:
FieldDescription
idPlayer unique identifier
nameFull player name
nicknameShort display name
shirt_numberPlayer shirt number
primary_position_namePlayer primary tactical position

​
Event Information

Each event represents a single match action recorded during the game.
FieldDescription
halfMatch half
minMinute of the event
secSecond of the event
timeInSecEvent time in seconds
team_idTeam responsible for the action
player_idPlayer performing the action
nicknamePlayer display name
xPitch X coordinate
yPitch Y coordinate
categoryEvent category (Attack, Possession, Defensive, etc.)
eventEvent type (Pass, Shoot, Cross, etc.)
resultResult of the action
extraAdditional information such as body part or pass type

​
Pitch Coordinate System

Events include pitch coordinates using the KoraStats coordinate system.
AxisRangeDescription
X axis0 → 100Goal to goal direction
Y axis0 → 100Left to right across the pitch

​
Example Response

## Example Response

<ResponseExample>

```json
{
  "result": "string",
  "message": "string",
  "data": {
    "match": {
      "status": {
        "intStatusID": "integer",
        "strStatus": "string"
      },
      "home": {
        "_type": "home",
        "id": "integer",
        "name": "string",
        "logo": "string",
        "lineup": {
          "player_id": {
            "_type": "player",
            "id": "integer",
            "name": "string",
            "nickname": "string",
            "shirt_number": "integer",
            "dob": "string",
            "primary_position_id": "integer",
            "primary_position_name": "string",
            "secondary_position_id": "integer",
            "secondary_position_name": "string"
          }
        },
        "sub": {
          "player_id": {
            "_type": "player",
            "id": "integer",
            "name": "string",
            "nickname": "string",
            "shirt_number": "integer",
            "dob": "string",
            "primary_position_id": "integer",
            "primary_position_name": "string",
            "secondary_position_id": "integer",
            "secondary_position_name": "string"
          }
        }
      },
      "away": {
        "_type": "away",
        "id": "integer",
        "name": "string",
        "logo": "string",
        "lineup": {
          "player_id": {
            "_type": "player",
            "id": "integer",
            "name": "string",
            "nickname": "string",
            "shirt_number": "integer",
            "dob": "string",
            "primary_position_id": "integer",
            "primary_position_name": "string",
            "secondary_position_id": "integer",
            "secondary_position_name": "string"
          }
        },
        "sub": {
          "player_id": {
            "_type": "player",
            "id": "integer",
            "name": "string",
            "nickname": "string",
            "shirt_number": "integer",
            "dob": "string",
            "primary_position_id": "integer",
            "primary_position_name": "string",
            "secondary_position_id": "integer",
            "secondary_position_name": "string"
          }
        }
      },
      "events": [
        {
          "_type": "event",
          "_id": "integer",
          "half": "integer",
          "min": "integer",
          "sec": "integer",
          "msec": "float",
          "timeInSec": "float",
          "team_id": "integer",
          "team": "string",
          "player_id": "integer",
          "nickname": "string",
          "shirt_number": "integer",
          "x": "integer",
          "y": "integer",
          "category": "string",
          "category_id": "integer",
          "event": "string",
          "event_id": "integer",
          "result": "string",
          "result_id": "integer",
          "extra": "string",
          "extra_id": "integer",
          "body_part": "string",
          "body_part_id": "integer",
          "guid": "string",
          "guid_ref": "string"
        }
      ]
    }
  }
}