​
Overview

The MatchPossessionTimeline endpoint returns the possession distribution throughout a match, broken down into standard 15-minute intervals. This endpoint provides insight into how possession changed during different phases of the game, helping analysts understand match momentum and control. The response includes:
  • Match information
  • Teams and coaches
  • Scoreline
  • Possession percentages per time segment for both teams
Typical possession intervals include:
  • 00-15
  • 15-30
  • 30-45
  • 45-60
  • 60-75
  • 75-90

​
Parameters

​
module
string
Always use api
​
api
string
API name. Use MatchPossessionTimeline
​
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
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=MatchPossessionTimeline&version=V2&response=json&lang=en&match_id=25997&key=YOUR_API_KEY"

{
  "result": "Success",
  "message": "Match possession timeline retrieved.",
  "data": {
    "_type": "MATCH",
    "id": 25997,
    "tournament": "string",
    "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"
    },

    "score": {
      "home": "integer",
      "away": "integer"
    },

    "home": {
      "_type": "TEAM",
      "team": {
        "id": "integer",
        "name": "string"
      },
      "coach": {
        "id": "integer",
        "name": "string"
      },
      "possession": [
        {
          "_type": "POSSESSION",
          "period": "00-15",
          "possession": "integer",
          "score": {
            "home": "integer",
            "away": "integer"
          }
        }
      ]
    },

    "away": {
      "_type": "TEAM",
      "team": {
        "id": "integer",
        "name": "string"
      },
      "coach": {
        "id": "integer",
        "name": "string"
      },
      "possession": [
        {
          "_type": "POSSESSION",
          "period": "00-15",
          "possession": "integer",
          "score": {
            "home": "integer",
            "away": "integer"
          }
        }
      ]
    }
  }
}

​
Possession Timeline

Possession is provided in 15-minute segments, representing the percentage of ball possession for each team during that interval.
PeriodDescription
00-15Opening phase of the match
15-30Mid first half
30-45End of first half
45-60Early second half
60-75Mid second half
75-90Final phase of regulation time
Each entry also includes the current match score during that interval, allowing analysts to correlate possession shifts with match events such as goals.