​
Overview

The MatchEventList API returns the complete timeline of match events recorded during a football match. Each event includes:
  • Time information (minute and second)
  • Player and team information
  • Event category and type
  • Event result
  • Pitch coordinates
The events are returned in chronological order, allowing systems to reconstruct the full match sequence.

​
Typical Use Cases

This endpoint is commonly used for:
  • Match replay engines
  • Tactical analysis platforms
  • Event timeline visualization
  • Broadcast graphics systems
  • Performance analysis tools
  • AI scouting systems

​
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.
​
match_id
integer
Unique identifier of the match whose events are requested.
​
since
integer
Optional timestamp used to retrieve only events recorded after a specific moment. Useful for incremental synchronization.
​
lang
string
Language of the response (en for English, ar for Arabic).
​
response
string
Output format (json or xml).
​
key
string
API authentication key used to authorize the request.

​
Endpoint

​
GET api.php

curl "https://korastats.pro/pro/api.php?module=api&api=MatchEventList&version=V2&response=json&lang=en&match_id=30667&key=YOUR_API_KEY"

{
  "result": "Success",
  "message": "Events Retrieved",
  "data": {
    "_type": "MATCH EVENTS",
    "match": {
      "status": {
        "intStatusID": 10,
        "strStatus": "Approved"
      }
    },
    "home": {
      "id": 2307,
      "name": "PEC Zwolle U21",
      "logo": "https://cdn.korastats.com/teams/2307.png",
      "lineup": [],
      "sub": []
    },
    "away": {
      "id": 2248,
      "name": "FC Groningen U21",
      "logo": "https://cdn.korastats.com/teams/2248.png",
      "lineup": [],
      "sub": []
    },
    "events": [
      {
        "event_id": 1,
        "team_id": 2307,
        "player_id": 61674,
        "event_type": "PASS",
        "minute": 12,
        "second": 15,
        "x": 45,
        "y": 63,
        "result": "SUCCESS"
      }
    ]
  }
}