# Get match

Returns full information for a single match by its ID.

Endpoint: GET /match
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)
    Detailed information about a match

  - `response.id` (integer)
    Unique ID of the match
    Example: 1234

  - `response.league_id` (integer)
    ID of the league
    Example: 5

  - `response.home_team_id` (integer)
    ID of the home team
    Example: 10

  - `response.away_team_id` (integer)
    ID of the away team
    Example: 12

  - `response.timestamp` (integer)
    UNIX timestamp of the match start time
    Example: 1713261600

  - `response.timezone` (string)
    Timezone of the match
    Example: "UTC"

  - `response.start_date` (string)
    Formatted date and time of the match start
    Example: "2025-04-16 17:00:00"

  - `response.referee` (string,null)
    Name of the referee
    Example: "John Doe"

  - `response.venue_id` (integer,null)
    ID of the venue where the match is played
    Example: 3

  - `response.round` (string,null)
    Round of the match
    Example: "Round 5"

  - `response.group` (string,null)
    Group of the match (if applicable)
    Example: "Group A"

  - `response.season` (integer)
    Season of the match
    Example: 2025

  - `response.periods` (object)
    Start times for match periods

  - `response.periods.first` (integer,null)
    Start time of the first half (UNIX timestamp)
    Example: 1713261600

  - `response.periods.second` (integer,null)
    Start time of the second half (UNIX timestamp)
    Example: 1713265200

  - `response.status` (object)
    Match status details

  - `response.status.short` (string)
    Short match status code. Possible values:
     *  - TBD: Scheduled but date and time are not known
     *  - NS: Match is scheduled and has not started
     *  - 1H: First half is in progress
     *  - HT: Match is at halftime
     *  - 2H: Second half is in progress
     *  - ET: Extra time is being played
     *  - BT: Break during extra time
     *  - P: Penalty shootout is in progress
     *  - SUSP: Suspended by referee’s decision, may be rescheduled
     *  - INT: Match interrupted temporarily, should resume shortly
     *  - FT: Match finished in regular time
     *  - AET: Match finished after extra time
     *  - PEN: Match finished after penalties
     *  - PST: Postponed to a later date
     *  - CANC: Cancelled and will not be played
     *  - ABD: Abandoned before completion (e.g., weather, safety)
     *  - AWD: Technical loss awarded (not played)
     *  - WO: WalkOver — opponent forfeited
     *  - LIVE: In progress but detailed timing not available
    Enum: "TBD", "NS", "1H", "HT", "2H", "ET", "BT", "P", "SUSP", "INT", "FT", "AET", "PEN", "PST", "CANC", "ABD", "AWD", "WO", "LIVE"

  - `response.status.long` (string)
    Full textual label of the match status. Descriptions:
     *  - Time To Be Defined: Match scheduled but exact time unknown
     *  - Not Started: Match has not kicked off yet
     *  - First Half: First 45 minutes are being played
     *  - Halftime: Break between first and second half
     *  - Second Half: Second 45 minutes are being played
     *  - Extra Time: Additional time is being played after regular time
     *  - Break Time: Pause between extra time halves
     *  - Penalty In Progress: Penalty shootout is ongoing
     *  - Suspended: Match stopped by referee and may be rescheduled
     *  - Interrupted: Match temporarily paused, to resume soon
     *  - Match Finished: Ended in regular time
     *  - After Extra Time: Ended after extra time (no penalties)
     *  - Penalties: Ended after penalty shootout
     *  - Postponed: Delayed to another date
     *  - Cancelled: Match will not take place
     *  - Abandoned: Match stopped permanently due to incidents
     *  - Technical Loss: Forfeited due to technical decision
     *  - WalkOver: One team wins by default (no opponent)
     *  - In Progress: Match is ongoing (rare case, exact phase unknown)
    Example: "Match Finished"

  - `response.status.elapsed` (integer,null)
    Minutes elapsed
    Example: 90

  - `response.score` (object)
    Score details of the match

  - `response.score.home` (integer,null)
    Home team score
    Example: 2

  - `response.score.away` (integer,null)
    Away team score
    Example: 1

  - `response.score.detailed` (object)
    Detailed scoring breakdown

  - `response.score.detailed.half_time` (string)
    Score at half time
    Example: "1-1"

  - `response.score.detailed.full_time` (string)
    Final score at full time
    Example: "2-1"

  - `response.score.detailed.extra_time` (string)
    Score during extra time

  - `response.score.detailed.penalty` (string)
    Score during penalty shootout

  - `response.events` (object,null)
    List of match events (goals, cards, substitutions, etc.)

  - `response.statistics` (object,null)
    List of team statistics

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