---
title: "Top match statistics"
method: GET
path: "/matches/{match_id}/top_stats"
tags: ["Match"]
---

# Top match statistics

`GET /matches/{match_id}/top_stats`

## Request

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

Top statistics for the given match.

## Path parameters

- `match_id` integer, required

## Response `200`

OK

- object
  - `data` object
    - `home` object: Statistics for the home team.
      - `shots` object[]: Player with the most shots during this match
        - `id` integer: ID of the player.
        - `lastname` string: Lastname of the player.
        - `firstname` string: Firstname of the player.
        - `name` string: Name of the player.
        - `nickname` string: Nickname of the player.
        - `position_regular` 'Goalkeeper' | 'Defender' | 'Midfielder' | 'Forward' | 'Wing Back' | 'Full Back' | 'Central Defender' | 'Defensive Midfielder' | 'Attacking Midfielder' | 'Central Midfielder' | 'Winger' | 'Striker' | 'Second Striker' | 'Left' | 'Right' | 'Centre' | 'Left/Centre' | 'Centre/Right' | 'Left/Centre/Right' | 'Left/Right': Position the player plays regularly.
        - `position_match` 'goalie' | 'defenseman' | 'mid-fielder' | 'forward' | 'wing-back' | 'full-back' | 'central-defenseman' | 'defensing-mid-fielder' | 'attacking-mid-fielder' | 'central-mid-fielder' | 'winger' | 'striker' | 'second-striker' | 'left' | 'right' | 'center' | 'left-center' | 'center-right' | 'left-center-right' | 'left-right': Position the player plays in this match.
        - `formation_position` integer: Position in the [formation](../formations.html) of the player.
        - `uniform_number` integer: Number on uniform of the player.
        - `status` 'starter' | 'substitute': | value | description | |:-----------|:---------------------------| | starter | playing from the beginning | | substitute | on the bench |
        - `stats` object
          - `fouls` integer: Number of fouls commited by the player.
          - `touches` integer: Number ob times the player touched the ball.
          - `shots` integer: Number of shots done 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: Duels won in percentage by the player, in dfl tournaments, this statistics includes fifty_fifty and put_throught statistics.
          - `accurate_passes_in_percentage` number: 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 caused by the player.
          - `passes` integer: Number of passes done by the player.
    - `away` object: Statisticts for the away team. **NOT IMPLEMENTED** This field will **always** be an empty object
    - `overall` object: Statisticts for the whole match. **NOT IMPLEMENTED** This field will **always** be an empty object

## 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)