### Example response for GET /v2.2/markets/ Source: https://docs.soccersapi.com/markets/list Example JSON response showing the market list and metadata. The response includes `requests_left`, `user`, `plan`, pagination info, and a count of 8 markets. ```json { "data": [ { "id": "1", "name": "1X2, Full Time Result" }, { "id": "2", "name": "Over/Under, Goal Line" } ], "meta": { "requests_left": 2950, "user": "your_username", "plan": "Soccer API 50", "page": 1, "pages": 1, "count": 8, "total": 8, "msg": "" } } ``` -------------------------------- ### Example response for GET /v2.2/players/ Source: https://docs.soccersapi.com/players/list Example JSON response showing player data and pagination metadata. The response includes player details such as id, name, position, birthday, and country. The meta object contains pagination info (page, pages, count, total) and plan details. ```json { "data": [ { "id": 195, "team_id": null, "national_team_id": null, "name": "Mart Ristl", "common_name": "Ristl, Mart", "position": "M", "firstname": "Mart", "lastname": "Ristl", "birthday": "1996-07-07", "birthcountry": null, "birthplace": null, "shirtnumber": null, "weight": 74, "height": 178, "age": 30, "foot": "right", "img": "https://cdn.soccersapi.com/images/soccer/players/50/195.png", "market_value": null, "country": { "id": 4, "name": "Germany", "cc": "de" } }, { "id": 198, "team_id": null, "national_team_id": null, "name": "Dennis Jastrzembski", "common_name": "Jastrzembski, Dennis", "position": "F", "firstname": "Dennis", "lastname": "Jastrzembski", "birthday": "2000-02-20", "birthcountry": null, "birthplace": null, "shirtnumber": null, "weight": 77, "height": 176, "age": 26, "foot": null, "img": "https://cdn.soccersapi.com/images/soccer/players/50/198.png", "market_value": "$660000", "country": { "id": 4, "name": "Germany", "cc": "de" } } ], "meta": { "requests_left": 2950, "user": "your_username", "plan": "Soccer API 50", "page": 1, "pages": 100, "count": 100, "total": 9935, "msg": "" } } ``` -------------------------------- ### GET Match lineups Source: https://docs.soccersapi.com/fixtures Returns formations and starting lineups with position and shirt number. ```APIDOC ## GET Match lineups ### Description Returns formations and starting lineups with position and shirt number. ### Method GET ### Endpoint Match lineups ### Parameters #### Path Parameters - **match_id** (string) - Required - The unique identifier of the match. ### Response #### Success Response (200) - **lineups** (object) - Formations and starting lineups with position and shirt number. ``` -------------------------------- ### Example response for GET /v2.2/continents/ Source: https://docs.soccersapi.com/continents/list Example JSON response showing the data array with continent id and name, and meta information including requests_left, user, plan, pagination, and count. ```json { "data": [ { "id": 4, "name": "North America" }, { "id": 2, "name": "Europe" } ], "meta": { "requests_left": 2950, "user": "your_username", "plan": "Soccer API 50", "page": 1, "pages": 1, "count": 7, "total": 7, "msg": "" } } ``` -------------------------------- ### Example response for GET /v2.2/leagues/ Source: https://docs.soccersapi.com/leagues/list Example JSON response showing league objects with id, name, flags, current season/stage/round, continent, country, and seasons array, plus meta with pagination info (page, pages, count, total) and requests_left. ```json { "data": [ { "id": "6225", "name": "Oberliga NOFV", "is_cup": "0", "is_amateur": "1", "is_friendly": "0", "img": "https://cdn.soccersapi.com/images/soccer/leagues/100/6225.png", "id_current_season": "15860", "id_current_stage": null, "id_current_round": null, "continent": { "id": "2", "name": "Europe" }, "country": { "id": "4", "name": "Germany", "cc": "de" }, "seasons": [] }, { "id": "594", "name": "Bundesliga", "is_cup": "0", "is_amateur": "0", "is_friendly": "0", "img": "https://cdn.soccersapi.com/images/soccer/leagues/100/594.png", "id_current_season": "21268", "id_current_stage": "1", "id_current_round": "220932", "continent": { "id": "2", "name": "Europe" }, "country": { "id": "4", "name": "Germany", "cc": "de" }, "seasons": [] } ], "meta": { "requests_left": 2950, "user": "your_username", "plan": "Soccer API 50", "page": 1, "pages": 1, "count": 40, "total": 40, "msg": "" } } ``` -------------------------------- ### Example response for GET /v2.2/coaches/ Source: https://docs.soccersapi.com/coaches/list Example JSON response showing coach objects with id, team_id, name, common_name, firstname, lastname, birthday, birthcountry, birthplace, img, and nested country object. Includes meta with requests_left, user, plan, page, pages, count, total, and msg. ```json { "data": [ { "id": 3, "team_id": 2217, "name": "Roger Machado", "common_name": "Machado", "firstname": "Roger", "lastname": "Machado", "birthday": "1975-04-25", "birthcountry": null, "birthplace": null, "img": "https://cdn.soccersapi.com/images/soccer/coaches/50/3.png", "country": { "id": 25, "name": "Brazil", "cc": "br" } }, { "id": 19, "team_id": 3244, "name": "Tiago Nunes", "common_name": "Nunes", "firstname": "Tiago", "lastname": "Nunes", "birthday": "1980-02-15", "birthcountry": null, "birthplace": null, "img": "https://cdn.soccersapi.com/images/soccer/coaches/50/19.png", "country": { "id": 25, "name": "Brazil", "cc": "br" } } ], "meta": { "requests_left": 2950, "user": "your_username", "plan": "Soccer API 50", "page": 1, "pages": 3, "count": 100, "total": 211, "msg": "" } } ``` -------------------------------- ### Example response for GET /v2.2/countries/ Source: https://docs.soccersapi.com/countries/list Paginated response with 100 items per page. The response reports `meta.page` and `meta.pages`; a page beyond the last returns an empty `data`. ```json { "data": [ { "id": 136, "name": "Africa", "continent": "Africa", "sub_region": null, "code": null }, { "id": 9, "name": "Algeria", "continent": "Africa", "sub_region": null, "code": "dz" } ] } ``` -------------------------------- ### Request examples with lang parameter Source: https://docs.soccersapi.com/guides/languages These GET requests show how to use the `lang` parameter to localize catalogue data for different endpoints. The examples use `lang=es`, `fr`, `zht`, and `aa` for leagues, teams, countries, and standings respectively. ```http GET /v2.2/leagues/?api_key=API_KEY&t=info&id=583&lang=es GET /v2.2/teams/?api_key=API_KEY&t=info&id=20&lang=fr GET /v2.2/countries/?api_key=API_KEY&t=list&lang=zht&page=1 GET /v2.2/leagues/?api_key=API_KEY&t=standings&season_id=21033&lang=aa ``` -------------------------------- ### GET /v2.2/fixtures/ with include parameter Source: https://docs.soccersapi.com/guides/changelog Example request to fetch fixture information with related events and stats in a single call. The `include=events,stats` parameter reduces roundtrips and provides richer payloads. ```http GET /v2.2/fixtures/?api_key=API_KEY&t=info&id=XXXX&include=events,stats ``` -------------------------------- ### GET Round by ID (t=info) Source: https://docs.soccersapi.com/rounds Fetches a single round by its ID. Requires the id parameter. Example request: GET /v2.2/rounds/?api_key=API_KEY&t=info&id=1994 ```http GET /v2.2/rounds/?api_key=API_KEY&t=info&id=1994 ``` -------------------------------- ### Go example for fixture 2589310 Source: https://docs.soccersapi.com/ Go example using `net/http` to request fixture 2589310 with events and statistics. Reads the API key from the `SOCCERSAPI_API_KEY` environment variable. ```go package main import ( "fmt" "io" "net/http" "os" ) func main() { apiKey := os.Getenv("SOCCERSAPI_API_KEY") url := "https://api.soccersapi.com/v2.2/fixtures/?api_key=" + apiKey + "&t=info&id=2589310&season_id=21033&include=events,statistics" resp, err := http.Get(url) if err != nil { panic(err) } defer resp.Body.Close() body, _ := io.ReadAll(resp.Body) fmt.Println(string(body)) } ``` -------------------------------- ### GET Season by ID example Source: https://docs.soccersapi.com/seasons Example request to retrieve season details by ID using the 'info' operation. Requires the 'id' parameter and an API key. ```http GET /v2.2/seasons/?api_key=API_KEY&t=info&id=406 ``` -------------------------------- ### GET Rounds by season (t=byseason) Source: https://docs.soccersapi.com/rounds Fetches rounds of a season, with the current round flagged. Requires the season_id parameter. Example request: GET /v2.2/rounds/?api_key=API_KEY&t=byseason&season_id=406 ```http GET /v2.2/rounds/?api_key=API_KEY&t=byseason&season_id=406 ``` -------------------------------- ### C# example for fixture 2589310 Source: https://docs.soccersapi.com/ C# example using `HttpClient` to request fixture 2589310 with events and statistics. Reads the API key from the `SOCCERSAPI_API_KEY` environment variable. ```csharp using System; using System.Net.Http; using System.Threading.Tasks; class Program { static async Task Main() { var apiKey = Environment.GetEnvironmentVariable("SOCCERSAPI_API_KEY"); var url = $"https://api.soccersapi.com/v2.2/fixtures/?api_key={apiKey}&t=info&id=2589310&season_id=21033&include=events,statistics"; using var client = new HttpClient(); var response = await client.GetStringAsync(url); Console.WriteLine(response); } } ``` -------------------------------- ### GET /?t=match_lineups Source: https://docs.soccersapi.com/fixtures Retrieves formations and starting lineups with position and shirt number for a match. ```APIDOC ## GET /?t=match_lineups ### Description Retrieves formations and starting lineups with position and shirt number for a match. ### Method GET ### Endpoint /?t=match_lineups ### Parameters #### Query Parameters - **t** (string) - Required - Operation identifier, must be `match_lineups`. - **id** (integer) - Required - Match identifier. - **lang** (string) - Optional - Language code for localized data. ### Response #### Success Response (200) - **data** (object) - Lineup information including formations and starting lineups. #### Response Example { "data": {} } ``` -------------------------------- ### Competition page API calls (leagues, standings, fixtures, leaders, stats) Source: https://docs.soccersapi.com/guides/recipes Example GET requests for building a competition page. Requires Standard or World Cup plan for standings, leaders, and statistics; all plans for the rest. Standing rows include overall/home/away records, status, result, recent_form, and group for multiple tables. ```bash GET /v2.2/leagues/?api_key=API_KEY&t=info&id=583 # Premier League profile and current season GET /v2.2/seasons/?api_key=API_KEY&t=info&id=21033 # Premier League 2026/27 structure GET /v2.2/leagues/?api_key=API_KEY&t=standings&season_id=21033 # current table GET /v2.2/rounds/?api_key=API_KEY&t=byseason&season_id=21033 # match days and current round GET /v2.2/fixtures/?api_key=API_KEY&t=round&round_id=216028 # fixtures from the sampled round GET /v2.2/fixtures/?api_key=API_KEY&t=season&season_id=21033 # full 2026/27 fixture list GET /v2.2/leaders/?api_key=API_KEY&t=topscorers&season_id=21033 # also topassists, topcards GET /v2.2/stats/?api_key=API_KEY&t=season&id=21033 # season totals ``` -------------------------------- ### Example response for coach by ID Source: https://docs.soccersapi.com/coaches/info Example JSON response containing coach details such as name, team_id, and country. Includes meta information with plan and request count. ```json { "data": { "id": 662, "team_id": 99, "name": "Hans-Dieter Flick", "common_name": "Flick", "firstname": "Hans-Dieter", "lastname": "Flick", "birthday": "2065-02-24", "birthcountry": null, "birthplace": null, "img": "https://cdn.soccersapi.com/images/soccer/coaches/50/662.png", "country": { "id": 4, "name": "Germany", "cc": "de" } }, "meta": { "requests_left": 2950, "user": "your_username", "plan": "Soccer API 50", "page": 1, "pages": 1, "count": 1, "total": 1, "msg": "" } } ``` -------------------------------- ### Java example for fixture 2589310 Source: https://docs.soccersapi.com/ Java example using `HttpClient` to request fixture 2589310 with events and statistics. Reads the API key from the `SOCCERSAPI_API_KEY` environment variable. ```java import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; public class Main { public static void main(String[] args) throws Exception { String apiKey = System.getenv("SOCCERSAPI_API_KEY"); String url = "https://api.soccersapi.com/v2.2/fixtures/?api_key=" + apiKey + "&t=info&id=2589310&season_id=21033&include=events,statistics"; HttpClient client = HttpClient.newHttpClient(); HttpRequest request = HttpRequest.newBuilder() .uri(URI.create(url)) .build(); HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body()); } } ``` -------------------------------- ### Odds included with fixtures using odds_format Source: https://docs.soccersapi.com/guides/odds-formats Example GET requests that include odds_prematch or odds_inplay in fixture operations (info, season) and set the odds_format parameter. The examples show using odds_format=uk, us, and american. ```http GET /v2.2/fixtures/?api_key=API_KEY&t=info&id=2589310&include=odds_prematch&odds_format=uk GET /v2.2/fixtures/?api_key=API_KEY&t=info&id=2589310&include=odds_prematch,odds_inplay&bookmaker_ids=9,2&odds_format=us GET /v2.2/fixtures/?api_key=API_KEY&t=season&season_id=21033&include=odds_prematch&odds_format=american ``` -------------------------------- ### Ruby example for fixture 2589310 Source: https://docs.soccersapi.com/ Ruby example using `net/http` to request fixture 2589310 with events and statistics. Reads the API key from the `SOCCERSAPI_API_KEY` environment variable. ```ruby require 'net/http' require 'uri' api_key = ENV['SOCCERSAPI_API_KEY'] url = "https://api.soccersapi.com/v2.2/fixtures/?api_key=#{api_key}&t=info&id=2589310&season_id=21033&include=events,statistics" uri = URI(url) response = Net::HTTP.get(uri) puts response ``` -------------------------------- ### Example response for match lineups Source: https://docs.soccersapi.com/fixtures/match_lineups Shows the JSON structure returned by the endpoint, including home and away formations, confirmed formation flags, and squad arrays with player details. The `meta` object includes plan usage and request limits. ```json { "data": { "home": { "formation": "3-4-2-1", "confirmed_formation": 1, "squad": [ { "player": { "id": "323", "name": "Martinez, Emilano", "common_name": "Martinez, Emilano", "firstname": "Damian Emiliano", "lastname": "Martinez", "weight": "89", "height": "195", "img": "https://cdn.soccersapi.com/images/soccer/players/50/323.png", "country": { "id": "12", "name": "Argentina", "cc": "ar" } }, "number": "26", "captain": null, "position": "G", "position_name": null, "order": 1 } ] }, "away": { "formation": "4-2-3-1", "confirmed_formation": 1, "squad": [ { "player": { "id": "5393", "name": "Verbruggen, Bart", "common_name": "Verbruggen, Bart", "firstname": "Bart", "lastname": "Verbruggen", "weight": "87", "height": "193", "img": "https://cdn.soccersapi.com/images/soccer/players/50/5393.png", "country": { "id": "81", "name": "Netherlands", "cc": "nl" } }, "number": "1", "captain": null, "position": "G", "position_name": null, "order": 1 } ] } }, "meta": { "requests_left": 2950, "user": "your_username", "plan": "Soccer API 50", "page": 1, "pages": 1, "count": 1, "total": 1, "msg": "" } } ``` -------------------------------- ### GET venues by season Source: https://docs.soccersapi.com/guides/changelog Example request to fetch venues for a specific season using the `t=byseason` parameter and `season_id`. ```http GET /v2.2/venues/?api_key=API_KEY&t=byseason&season_id=14192 ``` -------------------------------- ### Example response for match_tvs Source: https://docs.soccersapi.com/broadcast/match_tvs Example JSON response showing an array of TV channels with their country details, followed by meta information including request count and pagination. ```json { "data": [ { "id": 187, "name": "SuperSport 3 Digitalb", "type": "Tv / Cable / Satellite", "country": { "id": 8, "name": "Albania", "cc": "al" } }, { "id": 55, "name": "beIN SPORTS CONNECT", "type": "Tv / Cable / Satellite", "country": { "id": 9, "name": "Algeria", "cc": "dz" } } ], "meta": { "requests_left": 2950, "user": "your_username", "plan": "Soccer API 50", "page": 1, "pages": 1, "count": 535, "total": 535, "msg": "" } } ``` -------------------------------- ### GET Matches by multiple IDs Source: https://docs.soccersapi.com/fixtures Returns several matches in one request, for example to refresh the matches shown on screen. ```APIDOC ## GET Matches by multiple IDs ### Description Returns several matches in one request, for example to refresh the matches shown on screen. ### Method GET ### Endpoint Matches by multiple IDs ### Parameters #### Query Parameters - **ids** (array) - Required - The unique identifiers of the matches to retrieve. ### Response #### Success Response (200) - **matches** (array) - List of match objects. ``` -------------------------------- ### Example response for Live standings Source: https://docs.soccersapi.com/leagues/standings_live JSON response containing league and season identifiers, standings array with team details, overall/home/away statistics, and meta information including requests_left and plan. ```json { "data": { "league_id": 594, "season_id": "406", "has_groups": 0, "number_standings": 1, "standings": [ { "team_id": "111", "team_name": "FC Bayern Munich", "group": "Bundesliga", "group_name": "", "overall": { "games_played": 34, "won": 26, "draw": 4, "lost": 4, "goals_diff": 68, "goals_scored": 100, "goals_against": 32, "points": 82, "position": 1 }, "home": { "games_played": 17, "won": 13, "draw": 2, "lost": 2, "goals_diff": 38, "goals_scored": 53, "goals_against": 15, "points": 41, "position": 1 }, "away": { "games_played": 17, "won": 13, "draw": 2, "lost": 2, "goals_diff": 30, "goals_scored": 47, "goals_against": 17, "points": 41, "position": 1 }, "total": 34, "status": "Promotion", "result": "Champions League", "points": 82 } ] }, "meta": { "requests_left": 2950, "user": "your_username", "plan": "Soccer API 50", "page": 1, "pages": 1, "count": 1, "total": 1, "msg": "" } } ``` -------------------------------- ### GET Group by ID (t=info) Source: https://docs.soccersapi.com/groups Retrieves a single group by its ID. Requires the id parameter. Example uses id=5108. ```http GET /v2.2/groups/?api_key=API_KEY&t=info&id=5108 ``` -------------------------------- ### GET All Continents (t=list) Source: https://docs.soccersapi.com/continents Example request to list all seven continents. Uses the `t=list` operation with no required or optional parameters. ```http GET /v2.2/continents/?api_key=API_KEY&t=list ``` -------------------------------- ### GET Groups by season (t=byseason) Source: https://docs.soccersapi.com/groups Retrieves groups of a season, listed under their stage. Requires the season_id parameter. Example uses season_id=7011. ```http GET /v2.2/groups/?api_key=API_KEY&t=byseason&season_id=7011 ``` -------------------------------- ### Example response for highlights by league Source: https://docs.soccersapi.com/media/league Example JSON response containing an array of highlight video objects with match details and YouTube URLs, plus metadata about the request. ```json { "data": [ [ { "id": 1843815, "league_id": 637, "season_id": 14341, "home_id": 116, "away_id": 118, "round_id": 182349, "stage_id": 207, "group_id": 1, "startdate": "2024-11-24 20:00:00", "title": "ATHLETIC CLUB 1 - 0 REAL SOCIEDAD I RESUMEN LALIGA EA SPORTS", "image": "https://i.ytimg.com/vi/aVy9O_x1Fe8/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=aVy9O_x1Fe8", "source": "www.youtube.com" }, { "id": 1843819, "league_id": 637, "season_id": 14341, "home_id": 121, "away_id": 113, "round_id": 182349, "stage_id": 207, "group_id": 1, "startdate": "2024-11-24 17:30:00", "title": "CD LEGANÉS 0 - 3 REAL MADRID I RESUMEN LALIGA EA SPORTS", "image": "https://i.ytimg.com/vi/pQVtyVtkGfM/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=pQVtyVtkGfM", "source": "www.youtube.com" }, { "id": 1843819, "league_id": 637, "season_id": 14341, "home_id": 121, "away_id": 113, "round_id": 182349, "stage_id": 207, "group_id": 1, "startdate": "2024-11-24 17:30:00", "title": "CD LEGANÉS 0 - 3 REAL MADRID I RESUMEN LALIGA EA SPORTS", "image": "https://i.ytimg.com/vi/9lStg3L28xQ/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=9lStg3L28xQ", "source": "www.youtube.com" } ] ], "meta": { "requests_left": 2950, "user": "your_username", "plan": "Soccer API 50", "pages": 1, "page": 1, "total": 56, "msg": "" } } ``` -------------------------------- ### Example response for Teams by season Source: https://docs.soccersapi.com/teams/byseason Example JSON response showing a list of teams with id, name, and country_id, along with metadata including requests_left, user, plan, pagination, and counts. ```json { "data": [ { "id": 2810, "name": "Werder Bremen", "country_id": 4 }, { "id": 111, "name": "FC Bayern Munich", "country_id": 4 } ], "meta": { "requests_left": 2950, "user": "your_username", "plan": "Soccer API 50", "page": 1, "pages": 1, "count": 19, "total": 19, "msg": "" } } ``` -------------------------------- ### Direct odds operations with odds_format Source: https://docs.soccersapi.com/guides/odds-formats Example GET requests for direct odds operations (match_odds, match_oddsinplay, match_odds_info) using the odds_format parameter with different formats (uk, us, fractional). The examples use Premier League fixture 2589310 from season 21033. ```http GET /v2.2/fixtures/?api_key=API_KEY&t=match_odds&id=2589310&odds_format=uk GET /v2.2/fixtures/?api_key=API_KEY&t=match_oddsinplay&id=2589310&odds_format=us GET /v2.2/fixtures/?api_key=API_KEY&t=match_odds_info&id=2589310&bookmaker_id=1&odds_format=fractional ``` -------------------------------- ### GET Continent by ID (t=info&id=2) Source: https://docs.soccersapi.com/continents Example request to fetch a single continent by its ID. Uses the `t=info` operation and requires the `id` parameter. ```http GET /v2.2/continents/?api_key=API_KEY&t=info&id=2 ``` -------------------------------- ### Python example for fixture 2589310 Source: https://docs.soccersapi.com/ Python example using `requests` to fetch fixture 2589310 with events and statistics. Reads the API key from the `SOCCERSAPI_API_KEY` environment variable. ```python import requests import os url = 'https://api.soccersapi.com/v2.2/fixtures/' params = { 'api_key': os.environ['SOCCERSAPI_API_KEY'], 't': 'info', 'id': '2589310', 'season_id': '21033', 'include': 'events,statistics' } response = requests.get(url, params=params) print(response.text) ``` -------------------------------- ### Example response for team last and next fixtures Source: https://docs.soccersapi.com/fixtures/last_next JSON response containing `next`, `current`, and `last` arrays with fixture details. The example shows a not-started next match and a finished last match. ```json { "data": { "next": [ { "id": 2632679, "status": "0", "status_name": "Notstarted", "status_period": null, "pitch": null, "referee_id": null, "round_id": "220259", "round_name": "4", "season_id": "21233", "season_name": "26/27", "stage_id": "1", "stage_name": "Regular Season", "group_id": "207", "group_name": "LaLiga", "aggregate_id": null, "winner_team_id": null, "venue_id": "737", "leg": null, "week": "36", "deleted": "0", "related_id": null, "info": null, "attendance": null, "time": { "datetime": "2026-09-06 14:15:00", "date": "2026-09-06", "time": "14:15:00", "minute": "", "timestamp": 1788704100, "timezone": "UTC" }, "teams": { "home": { "id": 103, "name": "CF Valencia", "short_code": "VCF", "img": "https://cdn.soccersapi.com/images/soccer/teams/80/103.png", "form": null, "coach_id": "6041", "kit_colors": { "home_main_color": "#ffffff", "home_second_color": "#ffffff", "home_number_color": "#040404", "home_gk_main_color": "#fa96c2", "home_gk_second_color": "#f5f5ed", "home_gk_number_color": "#000000" } }, "away": { "id": 99, "name": "FC Barcelona", "short_code": "BAR", "img": "https://cdn.soccersapi.com/images/soccer/teams/80/99.png", "form": null, "coach_id": "662", "kit_colors": { "away_main_color": "#e2cfa5", "away_second_color": "#120fa3", "away_number_color": "#000000", "away_gk_main_color": "#e46c3b", "away_gk_second_color": "#d58e50", "away_gk_number_color": "#050505" } } }, "league": { "id": 637, "name": "LaLiga", "type": "LaLiga", "country_id": "5", "country_name": "Spain", "country_code": "es", "country_flag": "https://cdn.soccersapi.com/images/countries/30/es.png" }, "scores": { "home_score": null, "away_score": null, "ht_score": "-", "ft_score": "-", "et_score": null, "ps_score": null }, "standings": { "home_position": 17, "away_position": 1 }, "assistants": { "first_assistant_id": null, "second_assistant_id": null, "fourth_assistant_id": null }, "coverage": { "has_lineups": 0, "has_tvs": 1, "has_standings": 1 }, "weather_report": null } ], "current": [], "last": [ { "id": 2632670, "status": "3", "status_name": "Finished", "status_period": null, "pitch": null, "referee_id": null, "round_id": "220258", "round_name": "3", "season_id": "21233", "season_name": "26/27", "stage_id": "1", "stage_name": "Regular Season", "group_id": "207", "group_name": "LaLiga", "aggregate_id": null, "winner_team_id": "99", "venue_id": "86", "leg": null, "week": "36", "deleted": "0" } ] } } ``` -------------------------------- ### Example response for All referees Source: https://docs.soccersapi.com/referees/list Example JSON response showing referee objects with id, name, common_name, firstname, lastname, birthday, img, and country details. The meta object includes pagination info (page, pages, count, total) and plan usage. ```json { "data": [ { "id": 22, "name": "Harm Osmers", "common_name": "Osmers", "firstname": "Harm", "lastname": "Osmers", "birthday": "1985-01-28", "img": "https://cdn.soccersapi.com/images/soccer/referees/50/22.png", "country": { "id": 4, "name": "Germany", "cc": "de" } }, { "id": 23, "name": "Patrick Ittrich", "common_name": "Ittrich", "firstname": "Patrick", "lastname": "Ittrich", "birthday": "1979-01-03", "img": "https://cdn.soccersapi.com/images/soccer/referees/50/23.png", "country": { "id": 4, "name": "Germany", "cc": "de" } } ], "meta": { "requests_left": 2950, "user": "your_username", "plan": "Soccer API 50", "page": 1, "pages": 4, "count": 100, "total": 343, "msg": "" } } ``` -------------------------------- ### GET /v2.2/livescores/?api_key=API_KEY&t=notstarted Source: https://docs.soccersapi.com/livescores/notstarted Request URL for the 'Today's matches not started' endpoint. Use t=notstarted to filter for matches that have not started. Paginated at 100 items per page; read meta.pages and use the page parameter to request subsequent pages. Authenticate with api_key=API_KEY in the URL or Authorization: Bearer API_KEY. ```http GET /v2.2/livescores/?api_key=API_KEY&t=notstarted ``` -------------------------------- ### GET League statistics, current season Source: https://docs.soccersapi.com/stats Example request for the `league` operation, returning season totals for a league. Requires the `id` parameter. Available on Standard and World Cup plans. ```http GET /v2.2/stats/?api_key=API_KEY&t=league&id=1005 ``` -------------------------------- ### Example response for search leagues Source: https://docs.soccersapi.com/search/league Example JSON response for a league search. Shows matching leagues with id, name, country_name, cc, and type, plus meta information. ```json { "data": [ { "id": 1855, "name": "2. Bundesliga, Women", "country_name": "Germany", "cc": "de", "type": "league" }, { "id": 592, "name": "2nd Bundesliga", "country_name": "Germany", "cc": "de", "type": "league" } ], "meta": { "requests_left": 2950, "user": "your_username", "plan": "Soccer API 50", "page": 1, "pages": 1, "count": 0, "total": 0, "msg": "" } } ```