---
title: "Team Statistics"
method: GET
path: "/matches/{match_id}/team_stats"
tags: ["Match"]
---

# Team Statistics

`GET /matches/{match_id}/team_stats`

## Request

- Base URL: `https://api.clubplatform.de/api`
- URL: `https://api.clubplatform.de/api/matches/{match_id}/team_stats`
- Auth: API key in query parameter `auth_token`

Return team statistics about the teams in the match.

## Path parameters

- `match_id` integer, required

## Headers

- `If-Modified-Since` string, date-time

## Response `200`

OK

- object
  - `data` object
    - `tournament_id` integer: ID of the tournament the match belongs.
    - `season_id` integer: ID of the season the match belongs.
    - `match_id` integer: ID of the match.
    - `teams` object[]: List of teams with details.
      - `id` integer: ID of the team.
      - `alignment` 'away' | 'home': Alignment of the team.
      - `average_age` integer: Average Age of this team.
      - `formation` 31213 | 31312 | 3142 | 3412 | 3421 | 343 | 3511 | 352 | 41212 | 4132 | 4141 | 4222 | 4231 | 4240 | 4312 | 4321 | 433 | 4411 | 442 | 451 | 532 | 541: Formation the team used in this match. More infos: - [31213](../formations.html#31213) - [31312](../formations.html#31312) - [3142](../formations.html#3142) - [3412](../formations.html#3412) - [3421](../formations.html#3421) - [343](../formations.html#343) - [3511](../formations.html#3511) - [352](../formations.html#352) - [41212](../formations.html#41212) - [4132](../formations.html#4132) - [4141](../formations.html#4141) - [4222](../formations.html#4222) - [4231](../formations.html#4231) - [4240](../formations.html#4240) - [4312](../formations.html#4312) - [4321](../formations.html#4321) - [433](../formations.html#433) - [4411](../formations.html#4411) - [442](../formations.html#442) - [451](../formations.html#451) - [532](../formations.html#532) - [541](../formations.html#541)
      - `stats` object
        - `score` integer: Number of goals scored by this team in the match.
        - `general` object: General statistic data of this team in this match.
          - `duels` integer: Total number of duels of this team in this match.
          - `duels_won` integer: Won duels of this team in this match.
          - `duels_lost` integer: Lost duels of this team in this match.
          - `fifty_fifty` integer: Fifty fifty duels of this team in this match.
          - `successful_fifty_fifty` integer: Won fifty fifty of this team in this match.
          - `put_throught` integer: Put throughts of this team in this match.
          - `successful_put_throught` integer: Succesful put throughts of this team in this match.
          - `duels_won_in_percentage` number, float: Duels won in percentage, in dfl tournaments, this statistics includes `fifty_fifty` and `put_throught` statistics.
          - `balls_touched` integer: Number of touched balls of this team in this match.
          - `possession` number, float: Ball possession as a percentage value.
          - `passes` integer: Total number of passes.
          - `accurate_passes_in_percentage` number, float: Accurate passes of th team in percentage.
          - `accurate_passes_back_zone_in_percentage` number, float: Accurate passes of the team in percentage in the own half of the pitch.
          - `accurate_passes_fwd_zone_in_percentage` number, float: Accurate passes of the team in percentage in the opponents half of the pitch.
        - `offensive` object: Statistics for offense of this team in this match.
          - `shots` integer: Number of total shots from this team.
          - `penalty_shots` integer: Number of penalty shots from this team.
          - `shots_on_goal` integer: Number of shots on goal from this team
          - `clear_cut_chance_shots` integer: Number of shots from clear cut chances from this team.
          - `freekicks` integer: Total number of attacking freekicks from this team.
          - `offside` integer: Number of offside situations of this team in the game.
          - `corner_kicks` integer: Number of corner kicks of this team in the game.
          - `corner_kicks_left` integer: Number of corner kicks of this team from the left side of the goal.
          - `corner_kicks_right` integer: Number of corner kicks of this team from the right side of the goal.
          - `shots_outside_box` integer: Number of shots from outside the penalty area of this team in the game.
          - `shots_inside_box` integer: Number of shots from inside the penalty area of this team in the game.
          - `shots_foot_outside_box` integer: Number of shots with foot from outside the penalty area of this team in the game.
          - `shots_foot_inside_box` integer: Number of shots with foot from inside the penalty area of this team in the game.
          - `shots_header` integer: Headers of team in the game.
          - `crosses` integer: Number of flanks.
          - `crosses_left` integer: Number of flanks from the left side.
          - `crosses_right` integer: Number of flanks from the right side.
          - `woodwork_hits` integer: Total number of occasions the ball hits the woodwork in any situation.
          - `attacking_percentage_first_half` object: Attacking percentages on each side of the field for the first half
            - `left` number, float: Percentage of attacks carried out over the left side of the pitch.
            - `right` number, float: Percentage of attacks carried out over the right side of the pitch.
            - `middle` number, float: Percentage of attacks carried out through the center of the pitch.
          - `attacking_percentage_second_half` object: Attacking percentages on each side of the field for the second half
            - `left` number, float: Percentage of attacks carried out over the left side of the pitch.
            - `right` number, float: Percentage of attacks carried out over the right side of the pitch.
            - `middle` number, float: Percentage of attacks carried out through the center of the pitch.
          - `attacking_percentage_extra_time` object: Attacking percentages on each side of the field for extra time
            - `left` number, float: Percentage of attacks carried out over the left side of the pitch.
            - `right` number, float: Percentage of attacks carried out over the right side of the pitch.
            - `middle` number, float: Percentage of attacks carried out through the center of the pitch.
          - `attacking_percentage_overall` object: Attacking percentages on each side of the field for the whole match
            - `left` number, float: Percentage of attacks carried out over the left side of the pitch.
            - `right` number, float: Percentage of attacks carried out over the right side of the pitch.
            - `middle` number, float: Percentage of attacks carried out through the center of the pitch.
        - `defensive` object: Statistics for defensive of this team in this match.
          - `saves` integer: Saves from the goaltender of this team.
          - `ball_recovery` integer: Total number taking possession of a loose ball by a player.
          - `opponent_woodwork_hits` integer: Total number of occasions the ball hits the woodwork of the own goal.
        - `foul` object: Statistics for fouls of this team.
          - `fouls_suffered` integer: Number of fouls suffered by this team.
          - `fouls_committed` integer: Number of fouls comitted by this team.
          - `handballs` integer: Number of handballs comitted by this team.
          - `yellow_cards` integer: Number of yellow cards received by this team.
          - `yellow_red_cards` integer: Number of yellow red cards received by this team.
          - `red_cards` integer: Number of red cards received by this team.
          - `sent_offs` integer: Number of sent offs received by this team.
      - `players` object[]: List of team players with details.
        - `id` integer: ID of the player.
        - `lastname` string: Last name of the player.
        - `firstname` string: First name of the player.
        - `name` string: Name of the player.
        - `nickname` string: Nickname of the player.
        - `position_regular` string: Regular position of the player.
        - `position_match` string: Position of the player in this match.
        - `formation_position` integer: Position in the formation of the player in this match.
        - `uniform_number` integer: Uniform number of the player.
        - `status` 'bench' | 'starter': | value | description | |:--------|:---------------------------| | starter | playing from the beginning | | bench | on the bench |
        - `stats` object: Statistics about this player.
          - `fouls` integer: Fouls commited by the player.
          - `touches` integer: Count of the ball touches by the player.
          - `duels` integer: Duels by the player, in dfl tournaments, this statistics includes fifty_fifty and put_throught statistics.
          - `duels_won` integer: Duels won by the player, in dfl tournaments, this statistics includes fifty_fifty and put_throught statistics.
          - `duels_won_in_percentage` number, float: Duels won in percentage by the player, in dfl tournaments, this statistics includes fifty_fifty and put_throught statistics.
          - `accurate_passes_in_percentage` number, float: Accurate passes by the player in percentage.
          - `goals` integer: Number of goals, scored by the player.
          - `assists_for_shots_on_goal` integer: Number of assists, by the player, for shots on goal by other player.
          - `assists_for_goals` integer: Number of goal assists by the player.
          - `offsides` integer: Number of offsides of the player.
          - `passes` integer: Number of passes done by the player.
          - `shots` integer: Number of shots done by the player.
          - `average_position_full_x` number, float: Average X coordinate on the pitch during the whole match duration.
          - `average_position_full_y` number, float: Average Y coordinate on the pitch during the whole match duration.
          - `average_position_first_half_x` number, float: Average X coordinate on the pitch during the first half.
          - `average_position_first_half_y` number, float: Average Y coordinate on the pitch during the first half.
          - `average_position_second_half_x` number, float: Average X coordinate on the pitch during the second half.
          - `average_position_second_half_y` number, float: Average Y coordinate on the pitch during the second half.
          - `average_position_extra_time_x` number, float: Average X coordinate on the pitch during extra time.
          - `average_position_extra_time_y` number, float: Average Y coordinate on the pitch during extra time.
    - `action_area_statistic` object
      - `away` number, float: Percentage of action taking place on away side.
      - `home` number, float: Percentage of action taking place on home side.
      - `middle` number, float: Percentage of action taking place in neutral territory.

## Other responses

- `304`: Not Modified
- `401`: Unauthorized
- `404`: Not Found

---

[API](https://skmtc.dev/clubplatform/apis/clubplatform-api.md) - [All operations](https://skmtc.dev/clubplatform/apis/clubplatform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/clubplatform/apis/clubplatform-api/revisions/5c107a185e03?raw)
