Summary Basic V3

Overview

The Match Summary Basic API returns a compact team-level summary for one match. It combines match metadata, competition context, venue and officials, the current or final score, and a focused collection of performance statistics for the home and away teams. The statistics include passing, possession, goals and expected goals, corners, offsides, fouls, cards, attempts, and final-third penetration by attacking channel. Both teams use the same statistics schema, which makes the response suitable for direct comparison in dashboards, broadcast graphics, match centers, and post-match reports. The endpoint returns the latest stored snapshot when the request is made. For a live match, values may change as new events and scores are processed. The lastUpdateDateTime field identifies when the match record was most recently updated.

Typical Use Cases

Build a basic match statistics dashboard.
Display a home-versus-away comparison.
Populate broadcast or second-screen match graphics.
Show live or post-match scores and key team statistics.
Create match-center summary cards.
Feed reporting systems without retrieving the full detailed event dataset.
Visualize final-third entry distribution across five attacking zones.

Parameters

module

string

required

The API module. This value is fixed and must always be api.

api

string

required

The endpoint name. This value is fixed and must always be MatchSummaryBasic.

version

string

required

The API version. Use V3.

match_id

integer

required

The unique KoraStats match identifier. In this example, 79356 identifies Morocco vs Nigeria in the AFCON Women final.

lang

string

required

The response language code. Use en for English.

response

string

required

The response format. Use json.

key

string

required

Your KoraStats API key. Keep this value secure and do not expose it in public or client-side applications.

Endpoint

GET https://premium.korastats.pro/api.php

https://premium.korastats.pro/api.php?module=api&api=MatchSummaryBasic&version=V3&match_id=79356&lang=en&response=json&key=YOUR_API_KEY

Code Examples

curl --get "https://premium.korastats.pro/api.php" \
  --data-urlencode "module=api" \
  --data-urlencode "api=MatchSummaryBasic" \
  --data-urlencode "version=V3" \
  --data-urlencode "match_id=79356" \
  --data-urlencode "lang=en" \
  --data-urlencode "response=json" \
  --data-urlencode "key=YOUR_API_KEY"

Response Example

{
  "result": true,
  "title": "Success",
  "message": "Match summary retrieved successfully in 1.5539 seconds.",
  "object": {
    "_type": "MATCH_SUMMARY",
    "matchId": 79356,
    "tournament": {
      "id": 582,
      "name": "AFCON Women"
    },
    "season": {
      "id": 1356,
      "name": "Morocco 2025"
    },
    "stage": {
      "id": 2349,
      "name": "Final"
    },
    "group": {
      "id": 3224,
      "name": "Main"
    },
    "round": 1,
    "dateTime": "2025-07-26 23:00:00",
    "lastUpdateDateTime": "2025-07-27 16:11:22",
    "stadium": {
      "id": 4058,
      "name": "Rabat Olympic Stadium"
    },
    "referee": {
      "id": 11085,
      "name": "Antsino Twanyanyukwa"
    },
    "assistant1": {
      "id": 5257,
      "name": "Alice Umutesi"
    },
    "assistant2": {
      "id": 5568,
      "name": "Tabara Mbodji"
    },
    "score": {
      "home": 2,
      "away": 3
    },
    "stats": {
      "home": {
        "Pass": {
          "Total": 315,
          "Success": 216,
          "Accuracy": 0.6857
        },
        "Possession": {
          "Touches": {
            "Average": 0.49
          },
          "Time": {
            "Average": 780.3239999999998
          }
        },
        "GoalsScored": {
          "Total": 2,
          "XG": 1.3
        },
        "Admin": {
          "Corners": 3,
          "Offside": 0
        },
        "Fouls": {
          "Committed": 12
        },
        "Cards": {
          "Yellow": 0,
          "Red": 0
        },
        "Attempts": {
          "Total": 10,
          "Success": 3,
          "Accuracy": 0.3
        },
        "PenetrationFinalThird": {
          "Total": 13,
          "LeftFlank": 3,
          "LeftChannel": 1,
          "Center": 1,
          "RightChannel": 6,
          "RightFlank": 2
        }
      },
      "away": {
        "Pass": {
          "Total": 328,
          "Success": 219,
          "Accuracy": 0.6677
        },
        "Possession": {
          "Touches": {
            "Average": 0.51
          },
          "Time": {
            "Average": 876.0630000000009
          }
        },
        "GoalsScored": {
          "Total": 3,
          "XG": 3
        },
        "Admin": {
          "Corners": 5,
          "Offside": 2
        },
        "Fouls": {
          "Committed": 7
        },
        "Cards": {
          "Yellow": 0,
          "Red": 0
        },
        "Attempts": {
          "Total": 15,
          "Success": 5,
          "Accuracy": 0.3333
        },
        "PenetrationFinalThird": {
          "Total": 32,
          "LeftFlank": 8,
          "LeftChannel": 3,
          "Center": 8,
          "RightChannel": 5,
          "RightFlank": 8
        }
      }
    }
  }
}

Response Fields

Response Envelope

Field	Type	Description
`result`	boolean	Indicates whether the request completed successfully.
`title`	string	Short response status title.
`message`	string	Human-readable result message. The execution time included in this string varies per request.
`object`	object	Match metadata, score, and team statistics.

Match Summary

Field	Type	Description
`object._type`	string	Object discriminator. The value is `MATCH_SUMMARY`.
`object.matchId`	integer	Unique match identifier.
`object.tournament`	object	Tournament summary.
`object.season`	object	Season summary.
`object.stage`	object \| null	Competition stage containing the match.
`object.group`	object \| null	Group or structural stage container containing the match.
`object.round`	integer \| null	Match round within the stage.
`object.dateTime`	string \| null	Scheduled match date and time in `YYYY-MM-DD HH:mm:ss` format.
`object.lastUpdateDateTime`	string \| null	Date and time when the match record was last updated.
`object.stadium`	object \| null	Stadium assigned to the match.
`object.referee`	object \| null	Main referee.
`object.assistant1`	object \| null	First assistant referee.
`object.assistant2`	object \| null	Second assistant referee.
`object.score`	object	Current or final match score.
`object.stats`	object	Team statistics divided into `home` and `away`.

Reference Objects

Tournament, season, stage, group, stadium, referee, and assistant-referee values use compact reference objects.

Field	Type	Description
`{reference}.id`	integer	Unique identifier for the referenced record.
`{reference}.name`	string	Display name of the referenced record.

Score

Field	Type	Description
`object.score.home`	integer \| null	Current or final home-team score. May be `null` before the match starts.
`object.score.away`	integer \| null	Current or final away-team score. May be `null` before the match starts.

Team Statistics

The same structure appears under object.stats.home and object.stats.away. Paths below use {side} to represent either team.

Passing

Field	Type	Description
`stats.{side}.Pass.Total`	integer	Total pass attempts.
`stats.{side}.Pass.Success`	integer	Successful passes.
`stats.{side}.Pass.Accuracy`	number	Successful passes divided by total passes. Returned as a ratio from `0` to `1`; multiply by `100` for a percentage.

Possession

Field	Type	Description
`stats.{side}.Possession.Touches.Average`	number	Team possession share calculated from touches. Returned as a ratio from `0` to `1`; for example, `0.49` represents 49%.
`stats.{side}.Possession.Time.Average`	number	Possession-time value returned by the statistics engine, in seconds. The field is exposed under `Average` in the current schema.

Goals and Expected Goals

Field	Type	Description
`stats.{side}.GoalsScored.Total`	integer	Goals scored by the team.
`stats.{side}.GoalsScored.XG`	number	Total expected-goals value generated from the team’s attempts.

Administrative Statistics

Field	Type	Description
`stats.{side}.Admin.Corners`	integer	Corners awarded to the team.
`stats.{side}.Admin.Offside`	integer	Offside decisions against the team.

Fouls and Cards

Field	Type	Description
`stats.{side}.Fouls.Committed`	integer	Fouls committed by the team.
`stats.{side}.Cards.Yellow`	integer	Yellow cards received.
`stats.{side}.Cards.Red`	integer	Red cards received.

Attempts

Field	Type	Description
`stats.{side}.Attempts.Total`	integer	Total scoring attempts.
`stats.{side}.Attempts.Success`	integer	Successful attempts according to the KoraStats event classification.
`stats.{side}.Attempts.Accuracy`	number	Successful attempts divided by total attempts. Returned as a ratio from `0` to `1`.

Final-Third Penetration

Field	Type	Description
`stats.{side}.PenetrationFinalThird.Total`	integer	Total recorded entries into the final third.
`stats.{side}.PenetrationFinalThird.LeftFlank`	integer	Final-third entries through the left flank.
`stats.{side}.PenetrationFinalThird.LeftChannel`	integer	Final-third entries through the left half-space or channel.
`stats.{side}.PenetrationFinalThird.Center`	integer	Final-third entries through the central zone.
`stats.{side}.PenetrationFinalThird.RightChannel`	integer	Final-third entries through the right half-space or channel.
`stats.{side}.PenetrationFinalThird.RightFlank`	integer	Final-third entries through the right flank.

Pass.Accuracy, Possession.Touches.Average, and Attempts.Accuracy are ratios, not percentage values. For display, convert 0.6857 to 68.57%, 0.49 to 49%, and 0.3 to 30%.

PenetrationFinalThird.Total is the sum of the five zone values: LeftFlank, LeftChannel, Center, RightChannel, and RightFlank.

For matches that have not started or have incomplete analysis, scores, metadata, or individual statistics may be null, zero, or unavailable.

Error Response

If match_id is missing, the API returns a bad-request response using the standard KoraStats error envelope.

{
  "result": false,
  "title": "Bad Request",
  "message": "Match id not sent."
}

API documentation

Tournament Endpoints

Season Endpoints

Match Endpoints

Player Endpoints

Team Endpoints

Coach Endpoints

Referee Endpoints

Videos Endpoints

3rd Party Integration

Misc Endpoint

Overview

Typical Use Cases

Parameters

Endpoint

Code Examples

Response Example

Response Fields

Response Envelope

Match Summary

Reference Objects

Score

Team Statistics

Passing

Possession

Goals and Expected Goals

Administrative Statistics

Fouls and Cards

Attempts

Final-Third Penetration

Error Response

API documentation

Tournament Endpoints

Season Endpoints

Match Endpoints

Player Endpoints

Team Endpoints

Coach Endpoints

Referee Endpoints

Videos Endpoints

3rd Party Integration

Misc Endpoint

​Overview

​Typical Use Cases

​Parameters

​Endpoint

​Code Examples

​Response Example

​Response Fields

​Response Envelope

​Match Summary

​Reference Objects

​Score

​Team Statistics

​Passing

​Possession

​Goals and Expected Goals

​Administrative Statistics

​Fouls and Cards

​Attempts

​Final-Third Penetration

​Error Response

Overview

Typical Use Cases

Parameters

Endpoint

Code Examples

Response Example

Response Fields

Response Envelope

Match Summary

Reference Objects

Score

Team Statistics

Passing

Possession

Goals and Expected Goals

Administrative Statistics

Fouls and Cards

Attempts

Final-Third Penetration

Error Response