​
Overview

The MatchStatus API returns the current processing status of a match within the KoraStats analysis and quality control workflow. Each match progresses through several stages including analysis, review, corrections, and final approval.
This endpoint allows external systems to track the progress of match processing and determine when match data becomes available for use. The response contains:
  • Match identifier
  • Match name
  • Current workflow status
  • Status identifier
The status reflects the stage of analysis and validation currently applied to the match.

​
Typical Use Cases

This endpoint is commonly used for:
  • Monitoring match analysis progress
  • Synchronizing external platforms with KoraStats processing workflows
  • Triggering automated data ingestion once analysis is complete
  • Updating dashboards with match readiness status
  • Integrating match analysis pipelines with third-party systems

​
Parameters

​
module
string
Module API fixed and cannot be changed. Always use api.
​
api
string
Endpoint name. Use MatchStatus.
​
version
string
API version. Use V2.
​
match_id
integer
Unique identifier of the match whose status is requested.
​
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.

​
Match Status Workflow

Matches move through a structured analysis pipeline before final approval.
StatusDescription
NewThe match has been created and is ready for analysis.
Live AnalysisReal-time analysis is currently being performed during the match.
Recorded AnalysisThe match is being analyzed using recorded video.
AnalyzedInitial analysis has been completed and awaits quality review.
RevisionThe match is currently undergoing quality auditing and validation.
PendingQuality review is completed and the match is waiting for reassignment for corrections.
CTRLCorrections are being applied according to the quality report.
CompletedMatch processing is finished and waiting for the final review.
Final RevisionThe final review process is currently underway.
ApprovedThe match has been finalized and officially approved.

​
Example Request

curl --request GET \
--url "https://korastats.pro/pro/api.php?module=api&api=MatchStatus&version=V2&response=json&lang=en&match_id=25997&key=YOUR_API_KEY"

{
  "result": "string",
  "message": "string",
  "data": {
    "_type": "string",
    "matchId": "integer",
    "match_name": "string",
    "status_id": "integer",
    "status_value": "string"
  }
}

​
Response Structure

The API returns the current workflow status of a match.

​
Match Status Information

FieldTypeDescription
data.matchIdintegerUnique match identifier
data.match_namestringMatch name including teams and score
data.status_idintegerNumeric identifier representing the current workflow stage
data.status_valuestringHuman-readable match workflow status

​
Response Wrapper

FieldTypeDescription
resultstringIndicates whether the request was successful
messagestringResponse message describing the result
dataobjectObject containing the match status information