# Get match events

Returns a list of events (goals, cards, substitutions, etc.) for a given match.

Endpoint: GET /match-events
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` (array,null)

  - `response.type` (string)
    The type of event (e.g., Goal, Card, Substitution)
    Example: "Goal"

  - `response.team_id` (integer)
    ID of the team associated with the event
    Example: 12

  - `response.team_name` (string)
    Name of the team associated with the event
    Example: "Manchester United"

  - `response.assist` (string,null)
    Name of the player who assisted the goal, if applicable
    Example: "Bruno Fernandes"

  - `response.player_name` (string,null)
    Name of the player directly involved in the event
    Example: "Marcus Rashford"

  - `response.player_id` (integer,null)
    Unique id of the player directly involved in the event
    Example: 139345

  - `response.assist_player_id` (integer,null)
    ID of the player who assisted the goal, if applicable
    Example: 128233

  - `response.detail` (string,null)
    Detailed type of the event (e.g., Normal Goal, Own Goal, Penalty Missed)
    Example: "Normal Goal"

  - `response.elapsed_plus` (integer,null)
    Additional time beyond the regular minute (e.g., 1 for 45+1)
    Example: 1

  - `response.elapsed` (integer,null)
    Minute of the match when the event occurred
    Example: 45

  - `response.comments` (string,null)
    Optional comment describing the event in more detail
    Example: "Scored from outside the box"

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