# Get match statistics

Returns match statistics (shots, possession, fouls, etc.) for a given match.

Endpoint: GET /match-statistics
Version: 2.0.7
Security: bearerAuth

## Query parameters:

  - `id` (integer, required)
    Match ID
    Example: 372452

## Response 200 fields (application/json):

  - `status` (string)
    Example: "success"

  - `pagination` (object,null)
    Pagination info if applicable

  - `errors` (object,null)

  - `response` (object,null)
    Match statistics broken down by home and away teams

  - `response.shots_on_goal` (object)
    Shots on target by each team

  - `response.shots_on_goal.home` (integer)
    Example: 4

  - `response.shots_on_goal.away` (integer)
    Example: 6

  - `response.shots_off_goal` (object)
    Shots off target by each team

  - `response.total_shots` (object)
    Total number of shots by each team

  - `response.blocked_shots` (object)
    Blocked shots by each team

  - `response.shots_inside_box` (object)
    Shots taken inside the penalty box

  - `response.shots_outside_box` (object)
    Shots taken from outside the penalty box

  - `response.fouls` (object)
    Number of fouls committed

  - `response.corner_kicks` (object)
    Corner kicks awarded

  - `response.offsides` (object)
    Offsides committed

  - `response.ball_possession` (object)
    Ball possession percentage

  - `response.yellow_cards` (object)
    Number of yellow cards received

  - `response.red_cards` (object)
    Number of red cards received

  - `response.goalkeeper_saves` (object)
    Saves made by the goalkeepers

  - `response.total_passes` (object)
    Total passes completed

  - `response.passes_accurate` (object)
    Number of accurate passes

  - `response.passes_percentage` (object)
    Pass accuracy percentage

  - `response.expected_goals` (object)
    Expected goals (xG) metric

  - `response.goals_prevented` (object)
    Estimated goals prevented by goalkeepers

## Response 400 fields (application/json):

  - `status` (string)
    Example: "error"

  - `pagination` (object,null)

  - `errors` (array,null)

  - `errors.type` (string)
    Example: "validation_error"

  - `errors.data` (object)

  - `response` (object,null)

## Response 500 fields (application/json):

  - `status` (string)
    Example: "error"

  - `pagination` (object,null)

  - `errors` (array,null)

  - `errors.type` (string)
    Example: "validation_error"

  - `errors.data` (object)

  - `response` (object,null)