--- title: "Facts" method: GET path: "/matches/{match_id}/match_facts" tags: ["Match"] --- # Facts `GET /matches/{match_id}/match_facts` ## Request - Base URL: `https://api.clubplatform.de/api` - URL: `https://api.clubplatform.de/api/matches/{match_id}/match_facts` - Auth: API key in query parameter `auth_token` Return facts about the match. ## Path parameters - `match_id` integer, required ## Query parameters - `locale` 'de-DE' | 'en-GB' | 'nl-NL' - `club_id` number ## Headers - `If-Modified-Since` string, date-time ## Response `200` OK - object - `data` object - `match_id` integer: ID of the match. - `season_id` integer: ID of the season. - `season_name` string: ID of the name. - `tournament_id` integer: ID of the tournament. - `tournament_name` string: Name of the tournament. - `tournament_handle` string: Handle of the tournament. - `division_id` integer: ID of the division the match belongs to. - `division_name` string: Name of the division the match belongs to. - `round_id` integer: ID of the round the match belongs to. - `round_name` string: Name of the round the match belongs to. - `start_date_time` string, date-time: Time and date the match starts. - `live` boolean: True when the match is currently running. - `in_break` boolean: True when the match is currently in halftime break. - `period` 2 | 4: | value | description | |:------|:----------------------| | 2 | match has 90 minutes | | 4 | match has 120 minutes | - `period_in_words` '1. HZ' | '2. HZ' | 'Elfmeter.' | 'Ende' | 'Pause' | 'Verl. 1. HZ' | 'Verl. 2. HZ' | 'Vor Anpfiff': The information about the period. **NOTE**: the info will always be in the locale which is provide | value | description | |:------------|:---------------------------| | 1. HZ | First half of match | | 2. HZ | Second half of match | | Elfmeter. | Match is in shootout | | Ende | Match has ended | | Pause | Match is in regular break | | Verl. 1. HZ | First half of overtime | | Verl. 2. HZ | Second half of overtime | | Vor Anpfiff | Match has not been started | - `minutes_elapsed` integer: Total minutes elapsed. - `period_minutes_elapsed` integer: Minutes elapsed for the current period. - `has_overtime` boolean: True if the match has the first 15 minutes of overtime. - `has_overtime_2` boolean: True if the match has the second 15 minutes of overtime. - `has_penalty_shootout` boolean: True if the match is decided by penalty shootout. - `injury_time_elapsed` integer: Extratime elapsed in the current period in minutes. - `attendees` integer: Total numer of attendees of the current match. - `event_status` string: State of the current match. - `video_id` integer: This match's associated video ID, if existent. __Note:__ This field will only be populated if the request included the `club_id` query parameter. - `match_name` string: optional name of the match. - `cards` object[]: List of all cards of the current match. - `id` integer: ID of the card. - `recipient_id` integer: ID of the person who received the card. - `recipient_type` 'player': Role of the person which receives the card. - `club_id` integer: ID of the club. - `team_id` integer: ID of the team. - `match_id` integer: ID of the match. - `comment` string: Comment of the card. **NOTE**: the info will always be in the locale which is provide - `time` string, date-time: Date and time in which the person received the card. - `period` integer: Period in which the person received the card. - `reason` 'bad sportsmanship' | 'dangerous play' | 'delay of game' | 'dissent' | 'distance to the wall' | 'dive' | 'entering field' | 'fight' | 'foul' | 'foul and abusive language' | 'handball' | 'injured player on the field' | 'insulting language' | 'jubilance' | 'not properly checked in the game' | 'not visible' | 'off the ball foul' | 'other' | 'persistent infringement' | 'professional foul' | 'professional foul (handball)' | 'professional foul (last man)' | 'referee abuse' | 'roughing' | 'serious foul' | 'simulation' | 'spitting' | 'touching(ed) the referee' | 'unknown' | 'unsporting behaviour' | 'violent conduct' | 'entering referee review area' | 'excessive usage of review signal' | 'entering video operations room': | value | description | |:---------------------------------|:------------------------------------------------------------------| | bad sportsmanship | bad sportsmanship | | dangerous play | risking the wellbeing of the opponent | | delay of game | tactical game delay | | dissent | dissent | | distance to the wall | insufficient distance to wall during free kick | | dive | baffeled foul | | entering field | entering the field without permission | | fight | to resort to fisticuffs | | foul | foul play | | foul and abusive language | foul and abusive language | | handball | tactical handball | | injured player on the field | injured player on the field | | insulting language | groughing | | jubilance | jubilance | | not properly checked in the game | no or invalid permission to play | | not visible | unknown reason | | off the ball foul | foul without intention to hit the ball | | other | other breaches of rule | | persistent infringement | continuously violate the rules | | professional foul | tactical foul play | | professional foul (handball) | tactical hand ball | | professional foul (last man) | tactical foul to stop a player as last man on his way to the goal | | referee abuse | abuse the referee | | roughing | assaulting another person | | serious foul | serious foul | | simulation | pretend to be fouled or simmilar | | spitting | spitting to another player or referee | | touching(ed) the referee | touching the referee | | unknown | unknown reason | | unsporting behaviour | unsporting behaviour | | violent conduct | violent conduct | | entering referee review area | entering referee review area | | excessive usage of review signal | excessive usage of review signal | | entering video operations room | entering video operations room | - `injury_time_elapsed` integer: Elapsed injury time in minutes. - `minutes_elapsed` integer: Minute of the match in which the person receives the card. - `period_minutes_elapsed` integer: Minute of the period in which the person receives the card - `type` 'red-card' | 'yellow-card' | 'yellowred-card': | value | description | |:---------------|:----------------| | red-card | red card | | yellow-card | yellow card | | yellowred-card | yellow red card | - `player_uniform_number` integer: Uniform number of the person who received the card. - `player_position_regular` string: Position the booked person plays regularly. - `player_image_url` string: URL to the portrait image of the official - `corners` object[]: List of all corners of the current match. - `id` integer: ID of the corner. - `club_id` integer: ID of the club which won the corner. - `team_id` integer: ID of the team which won the corner. - `time` string, date-time: Date and time in which the team won the corner. - `period` integer: Period in which the team won the corner. - `match_id` integer: ID of the match. - `comment` string: Comment for the corner. **NOTE**: the info will always be in the locale which is provide - `injury_time_elapsed` integer: Elapsed injury time in minutes. - `minutes_elapsed` integer: Minute of the match in which the team won the corner. - `period_minutes_elapsed` integer: Minute of the period in which the team won the corner. - `var_decisions` object[]: List of all VAR decisions of the current match. - `id` integer: ID of the VAR event. - `match_id` integer: ID of the match. - `event_type` string: VAR decision event - `season_id` integer: ID of the season - `tournament_id` integer: ID of the tournament - `reviewing` 'goal' | 'goal_not_awarded' | 'penalty_awarded' | 'penalty_not_awarded' | 'card_upgrade' | 'mistaken_identity' | 'referee_decision_confirmed' | 'referee_decision_cancelled' | 'red_card_given' | 'review': | value | description | |:---------------------------------|:------------------------------------------------------------------| | goal | review of previously awarded goal | | goal_not_awarded | review of previously unawarded goal | | penalty_awarded | review of foul for awarded penalty | | penalty_not_awarded | review of foul for unawarded penalty | | card_upgrade | review of foul to upgrade yellow card | | mistaken_identity | review of mistakingly cautioning the wrong player | | referee_decision_confirmed | decision accepted | | referee_decision_cancelled | decision overturned | | red_card_given | review of foul for sending off a player | | review | review | - `comment` string: Comment for the review. **NOTE**: the info will always be in the locale which is provide - `time` string, date-time: Date and time when the event happened. - `period` integer: The half in which the event happened. - `injury_time_elapsed` integer: Extratime elapsed in the current period in minutes. - `minutes_elapsed` integer: Total minutes elapsed. - `period_minutes_elapsed` integer: Minute of the period in which the team won the corner. - `site` object: Location of the match. - `built` integer: Year when the venue was built. - `city` string: City where the match takes place. - `id` integer: ID of the location where the match takes place. - `name` string: Name of the location where the match takes place. - `pitch` object: Size of the pitch. - `x` integer: Length of the pitch. - `y` integer: Width of the pitch. - `postal_code` string: Postal code of the location where the match takes place. - `roof` boolean: True when the stadium has a roof. - `seats` integer: Bumber of seats/capacity of the venue. - `street` string: Street address of the location where the match takes place. - `surface` 'artificial_turf' | 'turf': Surface of the stadium. - `url` string: Website of the venue. - `substitutions` object[]: List of all substitutions of the current match. - `period` integer: Period in which the substitution takes place. - `period_minutes_elapsed` integer: Period in which the substitution takes place. - `minutes_elapsed` integer: Minute of the period in which the substitution place. - `replacing_player_id` integer: ID of the player which will replace. - `replacing_player_firstname` string: Firstname of the player which will replace. - `replacing_player_lastname` string: Lastname of the player which will replace. - `replacing_player_nickname` string: Nickname of the player which will replace. - `original_player_id` integer: ID of the original/leaving player. - `original_player_firstname` string: Firstname of the original/leaving player. - `original_player_lastname` string: Lastname of the original/leaving player. - `original_player_nickname` string: Nickname of the original/leaving player. - `club_id` integer: ID of the club. - `team_id` integer: ID of the team which substitude players. - `match_id` integer: ID of the match. - `comment` string: Comment of the substitution. **NOTE**: the info will always be in the locale which is provide - `injury_time_elapsed` integer: Elapsed injury time in minutes. - `time` string, date-time: Date and time in which the substitution takes place. - `teams` object[]: List of all teams in the current match. - `id` integer: ID of the team. - `alignment` 'away' | 'home': Alignment of the team. - `name` string: Name of the team. - `nickname` string: Nickname of the team. - `lineup_complete` string: True when lineup is completed. - `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) - `score` object: Score of this team in this match. - `final` integer: Final score of the match. - `period_1` integer: Score in the first period. - `period_2` integer: Score in the second period. - `period_3` integer: Score in the first period of overtime. - `period_4` integer: Score in the second period of overtime. - `period_5` integer: Score in the penalty shootout. - `club` object - `id` integer: ID of the club. - `link` string: API URL to the club. - `emblem` object: The club emblem in different resolutions. - `medium` string: URL to the image in medium resolution (300x300>). - `mini` string: URL to the image in mini resolution (36x36>). - `small` string: URL to the image in mini resolution (70x70>). - `officials` object[]: List of all officals of the team. - `birthplace` string: City where the official was born. - `date_of_birth` string, date: Date of birth of the official. - `firstname` string: First name of the official. - `join_date` string: Date when the official joined the team. - `lastname` string: Last name of the official. - `nationality` string: Nationality of the official. **NOTE**: the info will always be in the locale which is provide - `position` string: Position of the official in the team. - `players` object[]: List of players who has involved in this game. - `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 | - `portrait_image_url` string: URL of player's portrait image. - `goals` object[]: List of all goals in the current match. - `player_id` integer: ID of the player who has scored the goal. - `period` integer: Period in which the goal is scored. - `time` string, date-time: Date and time of the goal. - `type` 'regular' | 'own-goal' | 'penalty': | value | description | |:---------|:---------------------------------------------| | regular | a regular goal (counts in player statistics) | | own-goal | an own goal | | penalty | caused by a pentaly kick | - `outcome` 'scored' | 'missed' | 'saved': | value | description | |:-------|:--------------| | scored | a scored goal | | missed | a missed goal | | saved | a saved goal | - `club_id` integer: ID of the club the team belongs to. - `team_id` integer: ID of the team which has scored the goal. - `match_id` integer: ID of the match. - `assisting_player_id` integer: ID of the player who gave the assist to the goal. - `comment` string: Comment to the goal. **NOTE**: the info will always be in the locale which is provide - `injury_time_elapsed` integer: Elapsed injury time in minutes. - `minutes_elapsed` integer: Minute of the match in which the goal ist scored. - `period_minutes_elapsed` integer: Minute of the period in which the goal ist score. - `timetable_actions` object[]: List of all timetable actions in the current match. - `id` integer: ID of the timetable action. - `period` integer: Period in which the timetable action takes place. - `time` string, date-time: Date and time of the timetable action. - `match_id` integer: ID of the match. - `comment` string: Comment to the timetable action. **NOTE**: the info will always be in the locale which is provide - `type` string: Type of the timetable action. - `period_minutes_elapsed` integer: Minutes elapsed in this period. - `minutes_elapsed` integer: Total minutes elapsed. - `injury_time_elapsed` integer: Elapsed injury time in minutes. - `regular_period_duration` integer: The regular duration of the period in minutes, without any injury time. - `officials` object[]: List of all officials in the current match. - `position` string: Position of the official in the team. - `firstname` string: First name of official. - `lastname` string: Last name of official. ## 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)