GET
/
api.php
Match Live Status
curl --request GET \
  --url https://premium.korastats.pro/api.php
{
  "result": true,
  "title": "<string>",
  "message": "<string>",
  "object": {},
  "object._type": "<string>",
  "object.boolMatchIsOver": true,
  "object.boolAnalysisLive": true,
  "object.objCurrentTime": {
    "Half": 123,
    "Second": 123,
    "MatchTime": "<string>"
  },
  "object.objMatch.intID": 123,
  "object.objMatch.strName": "<string>",
  "object.objMatch.objHomeTeam": {},
  "object.objMatch.objHomeCoach": {},
  "object.objMatch.objAwayTeam": {},
  "object.objMatch.objAwayCoach": {},
  "object.objMatch.objReferee": {},
  "object.objMatch.objStadium": {
    "intID": 123,
    "strName": "<string>",
    "strCity": "<string>",
    "strCountry": "<string>"
  }
}
Returns the current operational status of a match together with its teams, coaches, officials, venue, and latest available match time. Use this endpoint to determine whether KoraStats live analysis is available, whether the match has finished, and the latest period and clock recorded for the match.

​
Request

curl --request GET \
  --url 'https://premium.korastats.pro/api.php?module=api&api=MatchLiveStatus&version=V2&response=json&lang=en&match_id=128167&key=YOUR_API_KEY'

​
Query parameters

​
module
string
required
Must be api.
​
api
string
required
Must be MatchLiveStatus.
​
version
string
required
API version. Use V2.
​
key
string
required
Your KoraStats API key.
​
match_id
integer
required
Unique KoraStats match ID.
​
lang
string
default:"en"
Response language code.
​
response
string
default:"json"
Response format. Use json.

​
Response example

{
  "result": true,
  "title": "Success",
  "message": "Current Match State",
  "object": {
    "_type": "MATCH_LIVE_STATUS",
    "objMatch": {
      "intID": 128167,
      "strName": "Australia x Egypt",
      "objHomeTeam": {
        "intID": 231,
        "strName": "Australia"
      },
      "objHomeCoach": {
        "intID": 5053,
        "strName": "Tony Popovic"
      },
      "objAwayTeam": {
        "intID": 17,
        "strName": "Egypt"
      },
      "objAwayCoach": {
        "intID": 1,
        "strName": "Hossam Hassan Hussein"
      },
      "objReferee": {
        "intID": 1643,
        "strName": "Gustavo Tejera"
      },
      "objStadium": {
        "intID": 2514,
        "strName": "Dallas Stadium",
        "strCity": "",
        "strCountry": "United States"
      }
    },
    "boolMatchIsOver": true,
    "boolAnalysisLive": true,
    "objCurrentTime": {
      "Half": 5,
      "Second": 458.182,
      "MatchTime": "5 07:38.182"
    }
  }
}

​
Response fields

​
Response envelope

​
result
boolean
Indicates whether the request succeeded.
​
title
string
Short response status.
​
message
string
Human-readable response message.
​
object
object
Match live-status payload.

​
Live status

​
object._type
string
Payload type. Always MATCH_LIVE_STATUS for this endpoint.
​
object.boolMatchIsOver
boolean
Indicates whether the match has finished.A value of true means the match is over. A value of false means the match has not yet been marked as finished.
​
object.boolAnalysisLive
boolean
Indicates whether live KoraStats analysis is enabled for the match.This field describes the availability of live analysis. It does not indicate whether the match itself is currently in play.
​
object.objCurrentTime
object
Latest available match period and clock.
Second is the elapsed time within the period identified by Half; it is not necessarily the total elapsed time across the entire match.

​
Match information

​
object.objMatch.intID
integer
Unique KoraStats match ID.
​
object.objMatch.strName
string
Display name of the match.
​
object.objMatch.objHomeTeam
object
Home team identity containing intID and strName.
​
object.objMatch.objHomeCoach
object
Home coach identity containing intID and strName.
​
object.objMatch.objAwayTeam
object
Away team identity containing intID and strName.
​
object.objMatch.objAwayCoach
object
Away coach identity containing intID and strName.
​
object.objMatch.objReferee
object
Referee identity containing intID and strName.
​
object.objMatch.objStadium
object
Match venue.
Poll this endpoint while monitoring a live match and use the fields independently:
  • Use boolAnalysisLive to confirm that live analysis is available.
  • Use boolMatchIsOver to determine when polling can stop.
  • Use objCurrentTime to display or synchronize the latest available match clock.
  • Use objMatch to identify the participants, officials, and venue.
Do not use boolAnalysisLive as a replacement for boolMatchIsOver. A completed match can still have boolAnalysisLive: true, as shown in the example response.

​
Status interpretation

boolAnalysisLiveboolMatchIsOverMeaning
truefalseLive analysis is available and the match is not marked as finished
truetrueLive analysis was enabled and the match is now finished
falsefalseLive analysis is not available and the match is not marked as finished
falsetrueThe match is finished and live analysis is not available

​
Integration example

const status = response.object;

if (status.boolAnalysisLive) {
  updateMatchClock(status.objCurrentTime.MatchTime);
}

if (status.boolMatchIsOver) {
  stopLivePolling();
}

​
Errors

The API uses the standard KoraStats error response: 
{
  "result": false,
  "title": "Bad Request",
  "message": "A valid match_id is required."
}
Common errors include an invalid API key, a missing or invalid match_id, and a match that cannot be found.