SoccersAPI

https://docs.soccersapi.com
Admin
SoccersAPI is a REST football API providing real-time livescores, fixtures, league standings, team...
Tokens:194,484
Snippets:1,067
Trust Score:8.1
Update:1 week ago
Show doc for...
Tokens:
Raw
### 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<String> 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": ""
  }
}
```
Tokens:
Raw