​
Overview

The MatchStatus API returns the current processing status of a match within the KoraStats analysis workflow. Each match goes through multiple stages from creation, live analysis, quality control, and final approval.
This endpoint allows external platforms to monitor the progress of match analysis and data validation. The response includes:
  • Match identifier
  • Match name
  • Current status ID
  • Current status value
  • Reference identifiers for external platforms
The status values represent the analysis and quality control pipeline used internally by KoraStats.

​
Typical Use Cases

This endpoint is commonly used for:
  • Monitoring match analysis progress
  • Synchronizing external platforms with KoraStats workflows
  • Triggering downstream processes when analysis is completed
  • Updating dashboards with match processing status
  • Integrating 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.
​
platform_id
integer
Identifier of the external platform requesting the status.
​
platform_match_id
string
External platform match identifier used to map the match between systems.
​
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

The match analysis process goes through several stages:
StatusDescription
NewThe game has been created and is ready for analysis.
Live AnalysisReal-time match analysis is currently in progress.
Recorded AnalysisThe match is being analyzed from recorded video.
AnalyzedThe analysis has been completed and is awaiting quality review.
RevisionThe match is currently undergoing quality auditing and validation.
PendingQuality review is completed and the match is waiting for reassignment to the analysis team for corrections.
CTRLCorrections are being applied according to the quality report.
CompletedThe match processing is finished and waiting for the final review.
Final RevisionThe final review process is currently in progress.
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&platform_id=1&platform_match_id=6972ba42bf5e8363067e0a37&key=YOUR_API_KEY"


{
  "result": "string",
  "message": "string",
  "data": {
    "_type": "string",
    "matchId": "integer",
    "match_name": "string",
    "status_id": "integer",
    "status_value": "string",
    "reference": {
      "platform": "string",
      "korastats_match_id": "integer",
      "external_match_id": "string"
    }
  }
}

​
Response Structure

​
Match Status Information

FieldDescription
matchIdUnique match identifier
match_nameMatch name including teams and score
status_idNumeric identifier of the current status
status_valueHuman-readable match workflow status

​
Reference Information

FieldDescription
reference.platformExternal platform name
reference.korastats_match_idMatch identifier in the KoraStats system
reference.external_match_idMatch identifier used by the external platform