FootyStats API

https://footystats.org/api/documentations
Admin
An API that offers programmatic access to comprehensive football statistics and data from...
Tokens:149,352
Snippets:275
Trust Score:9.9
Update:11 months ago
Show doc for...
Tokens:
Raw
### GET /test-call

Source: https://footystats.org/api/documentations/make-the-first-api-call

Test endpoint for verifying API connectivity and authentication. This is the first call you should make after obtaining your API Key to ensure proper setup and access to the FootyStats API.

```APIDOC
## GET /test-call

### Description
Test endpoint used to verify that your API Key is valid and that you have proper connectivity to the FootyStats API. This is the first call recommended after API setup.

### Method
GET

### Endpoint
https://api.football-data-api.com/test-call

### Parameters
#### Query Parameters
- **key** (string) - Required - Your unique API Key for authentication

### Request Example
```
https://api.football-data-api.com/test-call?key=YOURKEY
```

### Response
#### Success Response (200)
- **status** (string) - Confirmation that the API call was successful
- **message** (string) - Success message or API status information

#### Response Example
```json
{
  "status": "success",
  "message": "API Key is valid and connected"
}
```

### Usage Notes
- Replace "YOURKEY" with your actual API Key
- This endpoint can be tested directly in any web browser
- Recommended as the first verification step after API setup
```

--------------------------------

### Today's Matches API Query Parameters Examples

Source: https://footystats.org/api/documentations/todays-matches-matches-by-day

Example API request calls demonstrating how to use query parameters including timezone and date filtering. Shows pagination usage with the page parameter and specific date queries with timezone specification.

```http
GET https://api.football-data-api.com/todays-matches?key=example HTTP/1.1

GET https://api.football-data-api.com/todays-matches?key=YOURKEY&timezone=Europe/London HTTP/1.1

GET https://api.football-data-api.com/todays-matches?key=YOURKEY&date=2020-07-30 HTTP/1.1

GET https://api.football-data-api.com/todays-matches?key=YOURKEY&page=2 HTTP/1.1
```

--------------------------------

### Example JSON Response for League Data

Source: https://footystats.org/api/documentations/league-teams

Illustrates the structure of a successful JSON response when retrieving league data from the FootyStats API. The response includes pagination information ('pager') and a list of teams ('data'), with detailed stats for each team if requested.

```json
{
    "success": true,
    "pager": {
        "page": 1,
        "per_page": 50,
        "total_results": 20
    },
    "data": [
        {
            "id": 59,
            "original_id": 59,
            "name": "Arsenal FC",
            "cleanName": "Arsenal",
            "english_name": "Arsenal FC",
            "shortHand": "arsenal-fc",
            "country": "England",
            "continent": "",
            "image": "https://cdn.footystats.org/img/teams/england-arsenal-fc.png",
            "flag_element": null,
            "season": "2018/2019",
            "seasonClean": null,
            "url": "https://footystats.org/clubs/england/arsenal-fc",
            "stadium_name": "",
            "stadium_address": "",
            "table_position": 5,
            "performance_rank": 5,
            "risk": 87,
            "season_format": "Domestic League",
            "competition_id": 1625,
            "founded": "1886",
            "full_name": "Arsenal FC",
            "alt_names": [],
            "official_sites": [],
            "stats": {
                "previous_seasons": [],
                "suspended_matches": 0,
                "homeAttackAdvantage": 29,
                "homeDefenceAdvantage": 0,
                "homeOverallAdvantage": 0,
                "seasonGoals_overall": 56,
                "seasonGoals_home": [
                    "13",
                    "64",
                    "45+1",
                    "71",
                    "59",
                    "81",
                    "84",
                    "9",
                    "7",
                    "9",
                    "21",
                    "18",
                    "90+6",
                    "50",
                    "13",
                    "8",
                    "42",
                    "45",
                    "54",
                    "57",
                    "90",
                    "90+5",
                    "27",
                    "33",
                    "46",
                    "78",
                    "33",
                    "37",
                    "67",
                    "81",
                    "21",
                    "32",
                    "44",
                    "5",
                    "24",
                    "33"
                ],
                "seasonGoals_away": [
                    "58",
                    "85",
                    "21",
                    "32",
                    "58",
                    "29",
                    "57",
                    "60",
                    "66",
                    "69",
                    "63",
                    "12",
                    "63",
                    "87",
                    "68",
                    "20",
                    "86",
                    "43",
                    "86",
                    "16"
                ],
                "seasonConceded_overall": 48,
                "seasonConceded_home": [
                    "43",
                    "10",
                    "40",
                    "20",
                    "60",
                    "32",
                    "52",
                    "76",
                    "8",
                    "71",
                    "36",
                    "80",
                    "2",
                    "15",
                    "40",
                    "83",
                    "87",
                    "83",
                    "1",
                    "45+4",
                    "84",
                    "20",
                    "43",
                    "66"
                ],
                "seasonConceded_away": [
                    "41",
                    "49",
                    "58",
                    "53",
                    "81",
                    "45",
                    "30",
                    "68",
                    "75",
                    "21",
                    "45+2",
                    "38",
                    "35",
                    "54",
                    "28",
                    "84",
                    "45+2",
                    "51",
                    "90+1"
                ]
            }
        }
    ]
}
```

--------------------------------

### Today's Matches

Source: https://footystats.org/api/documentations/league-team

Get a list of football matches scheduled for the current day.

```APIDOC
## GET /api/matches/today

### Description
Retrieves all football matches scheduled for the current day across all supported leagues.

### Method
GET

### Endpoint
/api/matches/today

### Parameters
#### Query Parameters
* **token** (string) - Required - Your unique API authentication token.

### Request Example
```json
{
  "token": "YOUR_API_TOKEN"
}
```

### Response
#### Success Response (200)
- **matches** (array) - A list of match objects, each containing match ID, league, home team, away team, scores, and time.

#### Response Example
```json
{
  "matches": [
    {
      "match_id": 12345,
      "league": "Premier League",
      "home_team": "Manchester United",
      "away_team": "Liverpool",
      "score": "2-1",
      "time": "15:00"
    }
  ]
}
```
```

--------------------------------

### Get Over 2.5 Stats API Call

Source: https://footystats.org/api/documentations/over-2

This snippet demonstrates how to make a GET request to the Over 2.5 Stats endpoint. It requires your API key as a query parameter. The response includes pagination details, metadata about the request limits, and the actual data categorized into top teams, top fixtures, and top leagues.

```http
GET https://api.football-data-api.com/stats-data-over25?key=YOURKEY
```

--------------------------------

### GET /api/players/detailed/match-participation

Source: https://footystats.org/api/documentations/player-individual

Retrieve player match participation statistics including games started, games substituted in, and games substituted out across the season.

```APIDOC
## GET /api/players/detailed/match-participation

### Description
Retrieve player match participation statistics including total games started, games where player was substituted in, and games where player was substituted out across the season.

### Method
GET

### Endpoint
/api/players/detailed/match-participation

### Query Parameters
- **player_id** (string) - Required - The unique identifier for the player
- **season** (string) - Optional - Season identifier (e.g., "2023-2024")

### Response
#### Success Response (200)
- **games_started** (number) - Total number of games where the player started the match
- **games_subbed_in** (number) - Total number of games where the player was substituted in
- **games_subbed_out** (number) - Total number of games where the player was substituted out

#### Response Example
{
  "games_started": 32,
  "games_subbed_in": 8,
  "games_subbed_out": 28
}
```

--------------------------------

### Get League Referees - JSON Response Example

Source: https://footystats.org/api/documentations/league-referees

Example JSON response from the League Referees API endpoint showing a referee object with detailed statistics including appearances, goals, cards, penalties, and performance metrics. The response includes pagination information and an array of referee records for the specified league season.

```json
{
    "success": true,
    "pager": {
        "current_page": 1,
        "max_page": 1,
        "results_per_page": 200,
        "total_results": 21
    },
    "data": [
        {
            "id": 393,
            "competition_id": 2012,
            "full_name": "Michael Oliver",
            "first_name": "Michael",
            "last_name": "Oliver",
            "known_as": "Michael Oliver",
            "shorthand": "michael-oliver",
            "age": 35,
            "league": "Premier League",
            "league_type": "Domestic League",
            "url": "https://footystats.org/referees/england-r-michael-oliver",
            "season": "2019/2020",
            "continent": "eu",
            "starting_year": 2019,
            "ending_year": 2020,
            "birthday": 477705600,
            "nationality": "England",
            "appearances_overall": 32,
            "wins_home": 11,
            "wins_away": 13,
            "draws_overall": 8,
            "wins_per_home": 34,
            "wins_per_away": 41,
            "draws_per": 25,
            "btts_overall": 63,
            "btts_percentage": 63,
            "goals_overall": 96,
            "goals_home": 46,
            "goals_away": 50,
            "goals_per_match_overall": 3,
            "goals_per_match_home": 1.44,
            "goals_per_match_away": 1.56,
            "penalties_given_overall": 5,
            "penalties_given_home": 2,
            "penalties_given_away": 3,
            "penalties_given_per_match_overall": 0.16,
            "penalties_given_per_match_home": 0.06,
            "penalties_given_per_match_away": 0.09,
            "penalties_given_percentage_overall": 16,
            "penalties_given_percentage_home": 6,
            "penalties_given_percentage_away": 9,
            "cards_overall": 105,
            "cards_home": 54,
            "cards_away": 51,
            "cards_per_match_overall": 3.28,
            "cards_per_match_home": 1.69,
            "cards_per_match_away": 1.59,
            "over05_cards_overall": 31,
            "over15_cards_overall": 27,
            "over25_cards_overall": 17,
            "over35_cards_overall": 11,
            "over45_cards_overall": 10,
            "over55_cards_overall": 5,
            "over65_cards_overall": 2,
            "over05_cards_per_match_overall": 0.97,
            "over15_cards_per_match_overall": 0.84,
            "over25_cards_per_match_overall": 0.53,
            "over35_cards_per_match_overall": 0.34,
            "over45_cards_per_match_overall": 0.31,
            "over55_cards_per_match_overall": 0.16,
            "over65_cards_per_match_overall": 0.06,
            "over05_cards_percentage_overall": 97,
            "over15_cards_percentage_overall": 84,
            "over25_cards_percentage_overall": 53,
            "over35_cards_percentage_overall": 34,
            "over45_cards_percentage_overall": 31,
            "over55_cards_percentage_overall": 16,
            "over65_cards_percentage_overall": 6,
            "yellow_cards_overall": 105,
            "red_cards_overall": 0,
            "min_per_goal_overall": 30,
            "min_per_card_overall": 27
        }
    ]
}
```

--------------------------------

### GET /api/matches

Source: https://footystats.org/api/documentations/match-details

Retrieve football match data with various filtering and statistical parameters. You can test this API call by using the key 'example' and loading the matches from the English Premier League 2018/2019 season (ID: 1625).

```APIDOC
## GET /api/matches

### Description
Retrieve football match data with various filtering and statistical parameters. This endpoint allows for detailed queries to fetch match information, including team statistics, betting odds, and pre-match potentials.

### Method
GET

### Endpoint
/api/matches

### Parameters
#### Query Parameters
- **id** (integer) - Optional - ID of the match.
- **homeID** (integer) - Optional - ID of the home team.
- **awayID** (integer) - Optional - ID of the away team.
- **season** (string) - Optional - Season of the league (e.g., '2018/2019').
- **status** (string) - Optional - Status of the match ('complete', 'suspended', 'canceled', 'incomplete').
- **roundID** (integer) - Optional - Round ID of the match within the season.
- **game_week** (integer) - Optional - Game week of the match within the season.
- **homeGoals** (array) - Optional - Goal timings for home team goals.
- **awayGoals** (array) - Optional - Goal timings for away team goals.
- **homeGoalCount** (integer) - Optional - Number of home team goals.
- **awayGoalCount** (integer) - Optional - Number of away team goals.
- **totalGoalCount** (integer) - Optional - Number of total match goals.
- **team_a_corners** (integer) - Optional - Number of Home Team Corners.
- **team_b_corners** (integer) - Optional - Number of Away Team Corners.
- **team_a_offsides** (integer) - Optional - Number of Offsides - Home Team.
- **team_b_offsides** (integer) - Optional - Number of Offsides - Away Team.
- **team_a_yellow_cards** (integer) - Optional - Number of yellow cards - Home Team.
- **team_b_yellow_cards** (integer) - Optional - Number of yellow cards - Away Team.
- **team_a_red_cards** (integer) - Optional - Number of Red Cards - Home Team.
- **team_b_red_cards** (integer) - Optional - Number of Red Cards - Away Team.
- **team_a_shotsOnTarget** (integer) - Optional - Number of Shots On Target - Home Team.
- **team_b_shotsOnTarget** (integer) - Optional - Number of Shots On Target - Away Team.
- **team_a_shotsOffTarget** (integer) - Optional - Number of Shots Off Target - Home Team.
- **team_b_shotsOffTarget** (integer) - Optional - Number of Shots Off Target - Away Team.
- **team_a_shots** (integer) - Optional - Number of Shots - Home Team.
- **team_b_shots** (integer) - Optional - Number of Shots - Away Team.
- **team_a_fouls** (integer) - Optional - Number of Fouls - Home Team.
- **team_b_fouls** (integer) - Optional - Number of Fouls - Away Team.
- **team_a_possession** (string) - Optional - Possession of the Home Team.
- **team_b_possession** (string) - Optional - Possession of the Away Team.
- **refereeID** (integer) - Optional - ID of the referee for this match.
- **coach_a_ID** (integer) - Optional - ID of the coach for home team.
- **coach_b_ID** (integer) - Optional - ID of the coach for away team.
- **stadium_name** (string) - Optional - Name of the stadium.
- **stadium_location** (string) - Optional - Location of the stadium.
- **team_a_cards_num** (integer) - Optional - Number of cards for home team.
- **team_b_cards_num** (integer) - Optional - Number of cards for away team.
- **odds_ft_1** (float) - Optional - Odds for Home Team Win at FT.
- **odds_ft_x** (float) - Optional - Odds for Draw at FT.
- **odds_ft_2** (float) - Optional - Odds for Away Team Win at FT.
- **odds_ft_over05** (float) - Optional - Odds for Over 0.5 match goals.
- **odds_ft_over15** (float) - Optional - Odds for Over 1.5 match goals.
- **odds_ft_over25** (float) - Optional - Odds for Over 2.5 match goals.
- **odds_ft_over35** (float) - Optional - Odds for Over 3.5 match goals.
- **odds_ft_over45** (float) - Optional - Odds for Over 4.5 match goals.
- **odds_ft_under05** (float) - Optional - Odds for Under 0.5 match goals.
- **odds_ft_under15** (float) - Optional - Odds for Under 1.5 match goals.
- **odds_ft_under25** (float) - Optional - Odds for Under 2.5 match goals.
- **odds_ft_under35** (float) - Optional - Odds for Under 3.5 match goals.
- **odds_ft_under45** (float) - Optional - Odds for Under 4.5 match goals.
- **odds_btts_yes** (float) - Optional - Odds for BTTS Yes.
- **odds_btts_no** (float) - Optional - Odds for BTTS No.
- **odds_team_a_cs_yes** (float) - Optional - Odds for Clean Sheet Yes for Home team.
- **odds_team_a_cs_no** (float) - Optional - Odds for Clean Sheet No for Home team.
- **odds_team_b_cs_yes** (float) - Optional - Odds for Clean Sheet Yes for Away team.
- **odds_team_b_cs_no** (float) - Optional - Odds for Clean Sheet No for Away team.
- **overallGoalCount** (integer) - Optional - Total number of goals in the match.
- **ht_goals_team_a** (integer) - Optional - Number of home team goals by HT.
- **ht_goals_team_b** (integer) - Optional - Number of away team goals by HT.
- **HTGoalCount** (integer) - Optional - Total number of goals by HT.
- **date_unix** (integer) - Optional - UNIX timestamp of the match kick off.
- **winningTeam** (integer) - Optional - ID of the team that won. -1 if draw.
- **no_home_away** (integer) - Optional - Set to 1 if there is no home or away distinction for this match.
- **btts_potential** (float) - Optional - Pre-Match Stat for BTTS for both teams. Average between both teams.
- **o15_potential** (float) - Optional - Pre-Match Stat for Over 1.5 for both teams. Average between both teams.
- **o25_potential** (float) - Optional - Pre-Match Stat for Over 2.5 for both teams. Average between both teams.
- **o35_potential** (float) - Optional - Pre-Match Stat for Over 3.5 for both teams. Average between both teams.
- **o45_potential** (float) - Optional - Pre-Match Stat for Over 4.5 for both teams. Average between both teams.
- **o05HT_potential** (float) - Optional - Pre-Match Stat for Over 0.5 for both teams by HT. Average between both teams.
- **o15HT_potential** (float) - Optional - Pre-Match Stat for Over 1.5 for both teams by HT. Average between both teams.
- **corners_potential** (float) - Optional - Pre-Match average corners for both teams.
- **offsides_potential** (float) - Optional - Pre-Match average offsides for both teams.
- **cards_potential** (float) - Optional - Pre-Match average cards for both teams.
- **avg_potential** (float) - Optional - Pre-Match average total goals per match for both teams.
- **corners_o85_potential** (float) - Optional - Pre-Match Over 8.5 Corners for both teams.
- **corners_o95_potential** (float) - Optional - Pre-Match Over 9.5 Corners for both teams.
- **corners_o105_potential** (float) - Optional - Pre-Match Over 10.5 Corners for both teams.
- **u15_potential** (float) - Optional - Pre-Match Stat for Under 1.5 for both teams. Average between both teams.
- **u25_potential** (float) - Optional - Pre-Match Stat for Under 2.5 for both teams. Average between both teams.
- **u35_potential** (float) - Optional - Pre-Match Stat for Under 3.5 for both teams. Average between both teams.
- **u45_potential** (float) - Optional - Pre-Match Stat for Under 4.5 for both teams. Average between both teams.
- **home_ppg** (float) - Optional - Points per game for home team. Current.
- **away_ppg** (float) - Optional - Points per game for away team. Current.
- **pre_match_home_ppg** (float) - Optional - Pre-Match Points Per Game for Home Team.
- **pre_match_away_ppg** (float) - Optional - Pre-Match Points Per Game for Away Team.
- **competition_id** (integer) - Optional - Season ID of the league.
- **over05** (boolean) - Optional - Set to true if the match ended with Over 0.5 goals.
- **over15** (boolean) - Optional - Set to true if the match ended with Over 1.5 goals.
- **over25** (boolean) - Optional - Set to true if the match ended with Over 2.5 goals.
- **over35** (boolean) - Optional - Set to true if the match ended with Over 3.5 goals.
- **over45** (boolean) - Optional - Set to true if the match ended with Over 4.5 goals.
- **over55** (boolean) - Optional - Set to true if the match ended with Over 5.5 goals.
- **btts** (boolean) - Optional - Set to true if match ended with BTTS.
- **lineups** (boolean) - Optional - Include lineups. Players and their IDs that have participated in this match as the starting 11. Cards and Goal timings are also included.
- **bench** (boolean) - Optional - Include bench players. Players that have started on the bench. Includes time of substitution if substituted. Cards and Goal timings are also included.
- **trends** (boolean) - Optional - Include trends. Textual representation of statistical trends for team_a (Home) and team_b (Away).
- **team_a_card_details** (boolean) - Optional - Include home team card details. Yellow/Red Card details - Player ID, Card type, and timing of booking.
- **team_b_card_details** (boolean) - Optional - Include away team card details. Yellow/Red Card details - Player ID, Card type, and timing of booking.
- **h2h** (boolean) - Optional - Include Head to Head stats. Includes over X, wins, win percentages, previous match scores, and previous match ids.
- **odds_comparison** (boolean) - Optional - Include full line of odds.

### Request Example
```
GET /api/matches?season=2018/2019&competition_id=1625
```

### Response
#### Success Response (200)
- **id** (integer) - Unique identifier for the match.
- **homeTeamID** (integer) - ID of the home team.
- **awayTeamID** (integer) - ID of the away team.
- **seasonID** (integer) - ID of the season.
- **dateUTC** (string) - Date and time of the match in UTC.
- **status** (string) - Status of the match.
- **attendance** (integer) - Number of attendees.
- **stage** (string) - Stage of the competition.
- **last_period** (integer) - Last period of the match.
- **home_name** (string) - Name of the home team.
- **away_name** (string) - Name of the away team.
- **home_score** (integer) - Home team's score.
- **away_score** (integer) - Away team's score.
- **aggregate_home_score** (integer) - Aggregate home score for multi-leg matches.
- **aggregate_away_score** (integer) - Aggregate away score for multi-leg matches.
- **ht_home_score** (integer) - Home team's score at half-time.
- **ht_away_score** (integer) - Away team's score at half-time.
- **referee** (string) - Name of the referee.
- **stadium** (string) - Name of the stadium.
- **stadium_location** (string) - Location of the stadium.
- **match_day** (integer) - Match day number.
- **home_team_difficulty** (float) - Difficulty rating for the home team.
- **away_team_difficulty** (float) - Difficulty rating for the away team.
- **home_team_form** (string) - Home team's recent form.
- **away_team_form** (string) - Away team's recent form.
- **home_team_average_possession** (float) - Average possession for the home team.
- **away_team_average_possession** (float) - Average possession for the away team.
- **home_team_average_shots** (float) - Average shots for the home team.
- **away_team_average_shots** (float) - Average shots for the away team.
- **home_team_average_shots_on_target** (float) - Average shots on target for the home team.
- **away_team_average_shots_on_target** (float) - Average shots on target for the away team.
- **home_team_average_corners** (float) - Average corners for the home team.
- **away_team_average_corners** (float) - Average corners for the away team.
- **home_team_average_fouls** (float) - Average fouls for the home team.
- **away_team_average_fouls** (float) - Average fouls for the away team.
- **home_team_average_yellow_cards** (float) - Average yellow cards for the home team.
- **away_team_average_yellow_cards** (float) - Average yellow cards for the away team.
- **home_team_average_red_cards** (float) - Average red cards for the home team.
- **away_team_average_red_cards** (float) - Average red cards for the away team.
- **home_team_average_offsides** (float) - Average offsides for the home team.
- **away_team_average_offsides** (float) - Average offsides for the away team.
- **home_team_average_goals_scored** (float) - Average goals scored by the home team.
- **away_team_average_goals_scored** (float) - Average goals scored by the away team.
- **home_team_average_goals_conceded** (float) - Average goals conceded by the home team.
- **away_team_average_goals_conceded** (float) - Average goals conceded by the away team.
- **home_team_average_points_per_game** (float) - Average points per game for the home team.
- **away_team_average_points_per_game** (float) - Average points per game for the away team.
- **home_team_average_pre_match_ppg** (float) - Average pre-match points per game for the home team.
- **away_team_average_pre_match_ppg** (float) - Average pre-match points per game for the away team.
- **odds_ft_1** (float) - Odds for Home Team Win at Full Time.
- **odds_ft_x** (float) - Odds for Draw at Full Time.
- **odds_ft_2** (float) - Odds for Away Team Win at Full Time.
- **odds_ft_over05** (float) - Odds for Over 0.5 goals at Full Time.
- **odds_ft_over15** (float) - Odds for Over 1.5 goals at Full Time.
- **odds_ft_over25** (float) - Odds for Over 2.5 goals at Full Time.
- **odds_ft_over35** (float) - Odds for Over 3.5 goals at Full Time.
- **odds_ft_over45** (float) - Odds for Over 4.5 goals at Full Time.
- **odds_ft_under05** (float) - Odds for Under 0.5 goals at Full Time.
- **odds_ft_under15** (float) - Odds for Under 1.5 goals at Full Time.
- **odds_ft_under25** (float) - Odds for Under 2.5 goals at Full Time.
- **odds_ft_under35** (float) - Odds for Under 3.5 goals at Full Time.
- **odds_ft_under45** (float) - Odds for Under 4.5 goals at Full Time.
- **odds_btts_yes** (float) - Odds for Both Teams To Score - Yes.
- **odds_btts_no** (float) - Odds for Both Teams To Score - No.
- **odds_team_a_cs_yes** (float) - Odds for Home Team Clean Sheet - Yes.
- **odds_team_a_cs_no** (float) - Odds for Home Team Clean Sheet - No.
- **odds_team_b_cs_yes** (float) - Odds for Away Team Clean Sheet - Yes.
- **odds_team_b_cs_no** (float) - Odds for Away Team Clean Sheet - No.
- **btts** (boolean) - True if Both Teams Scored.
- **over05** (boolean) - True if Over 0.5 goals scored.
- **over15** (boolean) - True if Over 1.5 goals scored.
- **over25** (boolean) - True if Over 2.5 goals scored.
- **over35** (boolean) - True if Over 3.5 goals scored.
- **over45** (boolean) - True if Over 4.5 goals scored.
- **over55** (boolean) - True if Over 5.5 goals scored.
- **team_a_cards** (integer) - Total cards for the home team.
- **team_b_cards** (integer) - Total cards for the away team.
- **team_a_corners** (integer) - Total corners for the home team.
- **team_b_corners** (integer) - Total corners for the away team.
- **team_a_offsides** (integer) - Total offsides for the home team.
- **team_b_offsides** (integer) - Total offsides for the away team.
- **team_a_shots** (integer) - Total shots for the home team.
- **team_b_shots** (integer) - Total shots for the away team.
- **team_a_shots_on_target** (integer) - Total shots on target for the home team.
- **team_b_shots_on_target** (integer) - Total shots on target for the away team.
- **team_a_shots_off_target** (integer) - Total shots off target for the home team.
- **team_b_shots_off_target** (integer) - Total shots off target for the away team.
- **team_a_fouls** (integer) - Total fouls for the home team.
- **team_b_fouls** (integer) - Total fouls for the away team.
- **team_a_possession** (string) - Possession percentage for the home team.
- **team_b_possession** (string) - Possession percentage for the away team.
- **ht_goals_team_a** (integer) - Home team goals at half-time.
- **ht_goals_team_b** (integer) - Away team goals at half-time.
- **HTGoalCount** (integer) - Total goals at half-time.
- **winningTeam** (integer) - ID of the winning team (-1 for draw).
- **no_home_away** (integer) - Indicates if there is no home/away distinction (1 if true, 0 if false).
- **btts_potential** (float) - Pre-match BTTS potential average.
- **o15_potential** (float) - Pre-match Over 1.5 potential average.
- **o25_potential** (float) - Pre-match Over 2.5 potential average.
- **o35_potential** (float) - Pre-match Over 3.5 potential average.
- **o45_potential** (float) - Pre-match Over 4.5 potential average.
- **o05HT_potential** (float) - Pre-match Over 0.5 HT potential average.
- **o15HT_potential** (float) - Pre-match Over 1.5 HT potential average.
- **corners_potential** (float) - Pre-match corners potential average.
- **offsides_potential** (float) - Pre-match offsides potential average.
- **cards_potential** (float) - Pre-match cards potential average.
- **avg_potential** (float) - Pre-match average goals potential.
- **corners_o85_potential** (float) - Pre-match Over 8.5 corners potential.
- **corners_o95_potential** (float) - Pre-match Over 9.5 corners potential.
- **corners_o105_potential** (float) - Pre-match Over 10.5 corners potential.
- **u15_potential** (float) - Pre-match Under 1.5 potential average.
- **u25_potential** (float) - Pre-match Under 2.5 potential average.
- **u35_potential** (float) - Pre-match Under 3.5 potential average.
- **u45_potential** (float) - Pre-match Under 4.5 potential average.

### Request Example
```json
{
  "example": "request body"
}
```

### Response
#### Success Response (200)
- **id** (integer) - Unique identifier for the match.
- **homeTeamID** (integer) - ID of the home team.
- **awayTeamID** (integer) - ID of the away team.
- **seasonID** (integer) - ID of the season.
- **dateUTC** (string) - Date and time of the match in UTC.
- **status** (string) - Status of the match.
- **attendance** (integer) - Number of attendees.
- **stage** (string) - Stage of the competition.
- **last_period** (integer) - Last period of the match.
- **home_name** (string) - Name of the home team.
- **away_name** (string) - Name of the away team.
- **home_score** (integer) - Home team's score.
- **away_score** (integer) - Away team's score.
- **aggregate_home_score** (integer) - Aggregate home score for multi-leg matches.
- **aggregate_away_score** (integer) - Aggregate away score for multi-leg matches.
- **ht_home_score** (integer) - Home team's score at half-time.
- **ht_away_score** (integer) - Away team's score at half-time.
- **referee** (string) - Name of the referee.
- **stadium** (string) - Name of the stadium.
- **stadium_location** (string) - Location of the stadium.
- **match_day** (integer) - Match day number.
- **home_team_difficulty** (float) - Difficulty rating for the home team.
- **away_team_difficulty** (float) - Difficulty rating for the away team.
- **home_team_form** (string) - Home team's recent form.
- **away_team_form** (string) - Away team's recent form.
- **home_team_average_possession** (float) - Average possession for the home team.
- **away_team_average_possession** (float) - Average possession for the away team.
- **home_team_average_shots** (float) - Average shots for the home team.
- **away_team_average_shots** (float) - Average shots for the away team.
- **home_team_average_shots_on_target** (float) - Average shots on target for the home team.
- **away_team_average_shots_on_target** (float) - Average shots on target for the away team.
- **home_team_average_corners** (float) - Average corners for the home team.
- **away_team_average_corners** (float) - Average corners for the away team.
- **home_team_average_fouls** (float) - Average fouls for the home team.
- **away_team_average_fouls** (float) - Average fouls for the away team.
- **home_team_average_yellow_cards** (float) - Average yellow cards for the home team.
- **away_team_average_yellow_cards** (float) - Average yellow cards for the away team.
- **home_team_average_red_cards** (float) - Average red cards for the home team.
- **away_team_average_red_cards** (float) - Average red cards for the away team.
- **home_team_average_offsides** (float) - Average offsides for the home team.
- **away_team_average_offsides** (float) - Average offsides for the away team.
- **home_team_average_goals_scored** (float) - Average goals scored by the home team.
- **away_team_average_goals_scored** (float) - Average goals scored by the away team.
- **home_team_average_goals_conceded** (float) - Average goals conceded by the home team.
- **away_team_average_goals_conceded** (float) - Average goals conceded by the away team.
- **home_team_average_points_per_game** (float) - Average points per game for the home team.
- **away_team_average_points_per_game** (float) - Average points per game for the away team.
- **home_team_average_pre_match_ppg** (float) - Average pre-match points per game for the home team.
- **away_team_average_pre_match_ppg** (float) - Average pre-match points per game for the away team.
- **odds_ft_1** (float) - Odds for Home Team Win at Full Time.
- **odds_ft_x** (float) - Odds for Draw at Full Time.
- **odds_ft_2** (float) - Odds for Away Team Win at Full Time.
- **odds_ft_over05** (float) - Odds for Over 0.5 goals at Full Time.
- **odds_ft_over15** (float) - Odds for Over 1.5 goals at Full Time.
- **odds_ft_over25** (float) - Odds for Over 2.5 goals at Full Time.
- **odds_ft_over35** (float) - Odds for Over 3.5 goals at Full Time.
- **odds_ft_over45** (float) - Odds for Over 4.5 goals at Full Time.
- **odds_ft_under05** (float) - Odds for Under 0.5 goals at Full Time.
- **odds_ft_under15** (float) - Odds for Under 1.5 goals at Full Time.
- **odds_ft_under25** (float) - Odds for Under 2.5 goals at Full Time.
- **odds_ft_under35** (float) - Odds for Under 3.5 goals at Full Time.
- **odds_ft_under45** (float) - Odds for Under 4.5 goals at Full Time.
- **odds_btts_yes** (float) - Odds for Both Teams To Score - Yes.
- **odds_btts_no** (float) - Odds for Both Teams To Score - No.
- **odds_team_a_cs_yes** (float) - Odds for Home Team Clean Sheet - Yes.
- **odds_team_a_cs_no** (float) - Odds for Home Team Clean Sheet - No.
- **odds_team_b_cs_yes** (float) - Odds for Away Team Clean Sheet - Yes.
- **odds_team_b_cs_no** (float) - Odds for Away Team Clean Sheet - No.
- **btts** (boolean) - True if Both Teams Scored.
- **over05** (boolean) - True if Over 0.5 goals scored.
- **over15** (boolean) - True if Over 1.5 goals scored.
- **over25** (boolean) - True if Over 2.5 goals scored.
- **over35** (boolean) - True if Over 3.5 goals scored.
- **over45** (boolean) - True if Over 4.5 goals scored.
- **over55** (boolean) - True if Over 5.5 goals scored.
- **team_a_cards** (integer) - Total cards for the home team.
- **team_b_cards** (integer) - Total cards for the away team.
- **team_a_corners** (integer) - Total corners for the home team.
- **team_b_corners** (integer) - Total corners for the away team.
- **team_a_offsides** (integer) - Total offsides for the home team.
- **team_b_offsides** (integer) - Total offsides for the away team.
- **team_a_shots** (integer) - Total shots for the home team.
- **team_b_shots** (integer) - Total shots for the away team.
- **team_a_shots_on_target** (integer) - Total shots on target for the home team.
- **team_b_shots_on_target** (integer) - Total shots on target for the away team.
- **team_a_shots_off_target** (integer) - Total shots off target for the home team.
- **team_b_shots_off_target** (integer) - Total shots off target for the away team.
- **team_a_fouls** (integer) - Total fouls for the home team.
- **team_b_fouls** (integer) - Total fouls for the away team.
- **team_a_possession** (string) - Possession percentage for the home team.
- **team_b_possession** (string) - Possession percentage for the away team.
- **ht_goals_team_a** (integer) - Home team goals at half-time.
- **ht_goals_team_b** (integer) - Away team goals at half-time.
- **HTGoalCount** (integer) - Total goals at half-time.
- **winningTeam** (integer) - ID of the winning team (-1 for draw).
- **no_home_away** (integer) - Indicates if there is no home/away distinction (1 if true, 0 if false).
- **btts_potential** (float) - Pre-match BTTS potential average.
- **o15_potential** (float) - Pre-match Over 1.5 potential average.
- **o25_potential** (float) - Pre-match Over 2.5 potential average.
- **o35_potential** (float) - Pre-match Over 3.5 potential average.
- **o45_potential** (float) - Pre-match Over 4.5 potential average.
- **o05HT_potential** (float) - Pre-match Over 0.5 HT potential average.
- **o15HT_potential** (float) - Pre-match Over 1.5 HT potential average.
- **corners_potential** (float) - Pre-match corners potential average.
- **offsides_potential** (float) - Pre-match offsides potential average.
- **cards_potential** (float) - Pre-match cards potential average.
- **avg_potential** (float) - Pre-match average goals potential.
- **corners_o85_potential** (float) - Pre-match Over 8.5 corners potential.
- **corners_o95_potential** (float) - Pre-match Over 9.5 corners potential.
- **corners_o
```
Tokens:
Raw