Introduction

API : Soccers' API
API Version : v2.2
API Contents : Football

Soccer's API is a RESTful service for real time soccer data. It is a PAID service with low price (starting from 39€ per month). Note that in order to access Soccer's API you must purchase related packages or apply for our free plan. If you want a custom plan please contact us.

Setup the API

After subscribe, login and go to https://soccersapi.com/dashboard/api-key Generate a {{TOKEN}} in your user Dashboard Take your {{USERNAME}} and your {{TOKEN}} Now you're ready to make calls to the API

After subscribe, login and go to https://soccersapi.com/dashboard/api-key
Generate a TOKEN in your user Dashboard
Take your USERNAME and your TOKEN
Now you're ready to make calls to the API

Authentication

API BASE URL

All API endpoints are relative to the base URL

 https://api.soccersapi.com/v2.2/

This a single API Endpoint URL without parameteres:

https://api.soccersapi.com/v2.2/countries/

This an API Endpoint URL with Query Parameters:

https://api.soccersapi.com/v2.2/countries/?user={{USERNAME}}&token={{TOKEN}}&t=list

(Make sure replace {{USERNAME}} and {{TOKEN}} values with yours.)

Statuses

Check the following table to know what status number means.
Status Name Description
0 Not Started The event is not started
1 Inplay The event is inplay
11 Half-time The event is in half-time.
12 Extra-time The event is in extra time.
13 Penalties The event is in penalties because extra time didn't determinate a winner.
14 Break-time Event is in break waiting for extra time or penalties.
15 Awarding Awarding of a victory to a contestant because there are no other contestants.
2 Update later Event will be updated later.
3 Ended Event has ended after 90 minutes.
31 After penalties Event has ended after penalty shootout.
32 After Extra-time The event has finished after extra time.
4 Postponed The event has been Postponed.
5 Cancelled The event has been Cancelled.
6 Abandoned The event has abandoned and will continue at a later time or day.
7 interrupted The event has been interrupted. Can be due to bad weather for example.
8 Suspended The event has been suspended.
9 Awarded Winner is beeing decided externally.
10 Delayed The event is delayed.
17 To be announced The event has not been verified yet.

Images

You can get images in four different sizes based on pixels

Get Images by Size

Leagues 18x18 - https://cdn.soccersapi.com/images/soccer/leagues/18/1005.png

Leagues 50x50 - https://cdn.soccersapi.com/images/soccer/leagues/50/1005.png

Leagues 80x80 - https://cdn.soccersapi.com/images/soccer/leagues/80/1005.png

Leagues 100x100 - https://cdn.soccersapi.com/images/soccer/leagues/100/1005.png

Teams 18x18 - https://cdn.soccersapi.com/images/soccer/teams/18/104.png

Teams 50x50 - https://cdn.soccersapi.com/images/soccer/teams/50/104.png

Teams 80x80 - https://cdn.soccersapi.com/images/soccer/teams/80/104.png

Teams 100x100 - https://cdn.soccersapi.com/images/soccer/teams/100/104.png

Players 18x18 - https://cdn.soccersapi.com/images/players/players/18/2261.png

Players 50x50 - https://cdn.soccersapi.com/images/players/players/50/2261.png

Players 80x80 - https://cdn.soccersapi.com/images/players/players/80/2261.png

Players 100x100 - https://cdn.soccersapi.com/images/players/players/100/2261.png

Bookmakers (1 size) - https://cdn.soccersapi.com/images/soccer/bookmakers/2.png

Changelog

Soccer's API Version 2.2

## [2.2] - 30/09/2020
###Fixed
- Fixtures endpoints datetime value to UTC

## [2.2] - 30/09/2020
###Added
- Endpoint Match Sidelined

## [2.2] - 30/09/2020
###Added
- Endpoint Match by Multiple IDs

## [2.2] - 29/09/2020
###Added
- Team Kit colors on Fixtures Endpoints

## [2.2] - 12/09/2020
###Added
- Endpoint Teams National

## [2.2] - 07/09/2020
###Added
- Endpoint Search by Keyword

## [2.2] - 04/09/2020
###Added
- Endpoint Stages by Season

## [2.2] - 03/09/2020
###Added
- Endpoint Stage by ID

## [2.2] - 27/08/2020
###Added
- Endpoint Group by ID

## [2.2] - 06/08/2020
###Added
- Team Kit Colors (Team by ID Endpoint)

## [2.2] - 06/08/2020
###Added
- Coverage info (Fixtures, Match by ID Endpoints)

## [2.2] - 03/08/2020
###Added
- Endpoint TV Schedule by Date (on Broadcast & TV section)

## [2.2] - 18/06/2020
###Added
- Endpoint H2H Team vs Team

## [2.2] - 17/06/2020
###Added
- Endpoint All Continents
- Endpoint Continent by ID
- Order ASC / DESC in Fixtures by Season Endpoint

## [2.2] - 14/06/2020
###Added
- Logos +800 leagues

## [2.2] - 06/06/2020
###Added
- Endpoint Team Transfers
- Endpoint Match H2H

## [2.2] - 03/06/2020
###Added
- Endpoint Match Odds by Bookmaker

## [2.2] - 25/05/2020
###Added
- Team Kit colors
- Endpoint Team Trophies

Search by String

The Search endpoint gives you a list of items by keyword (minimum 3 letters) and it allows filter by type (all, continent, country, league, team, player, referee).

GETAll, Continents, Countries, Leagues, Teams, Players, Referees

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringall
qstring{{QUERY}}

Response

Response Example

                    {
 "data": [
 {
 "id": "4",
 "name": "Germany",
 "cc": "de",
 "type": "country"
 },
 {
 "id": "36",
 "name": "Germany",
 "country_name": "World",
 "cc": null,
 "type": "team"
 },
 {
 "id": "454",
 "name": "Germany U21",
 "country_name": "World",
 "cc": null,
 "type": "team"
 },
 {
 "id": "1659",
 "name": "Germany (W)",
 "country_name": "World",
 "cc": null,
 "type": "team"
 },
 {
 "id": "3717",
 "name": "Germany U17",
 "country_name": "World",
 "cc": null,
 "type": "team"
 },
 {
 "id": "3726",
 "name": "Germany",
 "country_name": "World",
 "cc": null,
 "type": "team"
 },
 {
 "id": "4561",
 "name": "Germany U19 (W)",
 "country_name": "World",
 "cc": null,
 "type": "team"
 },
 {
 "id": "4923",
 "name": "Germany U19",
 "country_name": "World",
 "cc": null,
 "type": "team"
 },
 {
 "id": "5160",
 "name": "Germany U20 (W)",
 "country_name": "World",
 "cc": null,
 "type": "team"
 },
 {
 "id": "5354",
 "name": "Germany U17 (W)",
 "country_name": "World",
 "cc": null,
 "type": "team"
 },
 {
 "id": "9775",
 "name": "Germany",
 "country_name": "International",
 "cc": "",
 "type": "team"
 },
 {
 "id": "9829",
 "name": "East Germany",
 "country_name": "International",
 "cc": "",
 "type": "team"
 },
...

Test Endpoint

All Continents

The Continents endpoint gives you a list of all Continents.

GETAll Continents

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringlist

Response

Response Example

                    {
 "data": [
 {
 "id": "1",
 "name": "World"
 },
 {
 "id": "2",
 "name": "Europe"
 },
 {
 "id": "3",
 "name": "Africa"
 },
 {
 "id": "4",
 "name": "North America"
 },
 {
 "id": "5",
 "name": "South America"
 },
 {
 "id": "6",
 "name": "Asia"
 },
 {
 "id": "7",
 "name": "Oceania"
 }
 ],
...

Test Endpoint

Continent by ID

The Get Continent By ID Endpoint gives you data from a specific continent like its name and ID. It's useful for ordering and structuring navigation by countries and for classify leagues, teams, players...

GETContinent By Id

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringinfo
idstring{{CONTINENT_ID}}

Response

Response Example

                     {
 "data": {
 "id": "2",
 "name": "Europe"
 },
...

Test Endpoint

All Countries

The All Countries endpoint gives you a list of all Countries and data like its Name, Flag, IsoCode, Continent and other related Country data.

GETAll Countries

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringlist
pageinteger{{PAGE}}

Response

Response Example

                    {
 "data": [
 {
 "id": "1",
 "name": "International",
 "continent": "World",
 "sub_region": null,
 "code": ""
 },
 {
 "id": "2",
 "name": "International Clubs",
 "continent": "World",
 "sub_region": null,
 "code": ""
 },
 {
 "id": "3",
 "name": "England",
 "continent": "Europe",
 "sub_region": null,
 "code": "en"
 },
 {
 "id": "4",
 "name": "Germany",
 "continent": "Europe",
 "sub_region": null,
 "code": "de"
 },
 {
 "id": "5",
 "name": "Spain",
 "continent": "Europe",
 "sub_region": null,
 "code": "es"
 },
 {
 "id": "6",
 "name": "Italy",
 "continent": "Europe",
 "sub_region": null,
 "code": "it"
 },
 {
 "id": "7",
 "name": "France",
 "continent": "Europe",
 "sub_region": null,
 "code": "fr"
 },
 {
 "id": "8",
 "name": "Albania",
 "continent": "Europe",
 "sub_region": null,
 "code": "al"
 },
 {
 "id": "9",
 "name": "Algeria",
 "continent": "Africa",
 "sub_region": null,
 "code": "dz"
 },
 {
 "id": "10",
 "name": "Andorra",
 "continent": "Europe",
 "sub_region": null,
 "code": "ad"
 },
 {
 "id": "11",
 "name": "Angola",
 "continent": "Africa",
 "sub_region": null,
 "code": "ao"
 },
 {
 "id": "12",
 "name": "Argentina",
 "continent": "South America",
 "sub_region": null,
 "code": "ar"
 },
 {
 "id": "13",
 "name": "Armenia",
 "continent": "Europe",
 "sub_region": null,
 "code": "am"
 },
 {
 "id": "14",
 "name": "Australia",
 "continent": "Asia",
 "sub_region": null,
 "code": "au"
 },
 {
 "id": "15",
 "name": "Austria",
 "continent": "Europe",
 "sub_region": null,
 "code": "at"
 },
 {
 "id": "17",
 "name": "Azerbaijan",
 "continent": "Europe",
 "sub_region": null,
 "code": "az"
 },
 {
 "id": "18",
 "name": "Bahrain",
 "continent": "Asia",
 "sub_region": null,
 "code": "bh"
 },
 {
 "id": "19",
 "name": "Bangladesh",
 "continent": "Oceania",
 "sub_region": null,
 "code": "bd"
 },
...

Test Endpoint

Country by ID

The Get Country By Id Endpoint gives you data from a specific country like Name, Flag, IsoCode, Continent and other related Country data.

GETCountry By Id

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringinfo
idinteger{{COUNTRY_ID}}

Response

Response Example

                    {
 "data": {
 "id": "4",
 "name": "Germany",
 "continent": "Europe",
 "sub_region": null,
 "long": null,
 "lat": null,
 "img": "https://cdn.soccersapi.com/images/countries/30/de.png",
 "code": "de"
 },
...

Test Endpoint

All Leagues

The Get All Leagues Endpoint gives you a paginated list of all leagues available in your plan.

GETAll Leagues

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringlist
pageinteger{{PAGE}}

Response

Response Example

                    {
 "data": [
 {
 "id": "799",
 "name": "Ligue 1",
 "is_cup": "0",
 "is_amateur": "0",
 "continent_id": "3",
 "country_id": "9",
 "current_season_id": "8513",
 "current_round_id": "29659",
 "current_stage_id": null
 },
 {
 "id": "798",
 "name": "Algeria Cup",
 "is_cup": "1",
 "is_amateur": "0",
 "continent_id": "3",
 "country_id": "9",
 "current_season_id": "9523",
 "current_round_id": "7648",
 "current_stage_id": null
 },
 {
 "id": "800",
 "name": "Ligue 2",
 "is_cup": "0",
 "is_amateur": "0",
 "continent_id": "3",
 "country_id": "9",
 "current_season_id": "10027",
 "current_round_id": "29660",
 "current_stage_id": null
 },
 {
 "id": "801",
 "name": "Super Cup",
 "is_cup": "1",
 "is_amateur": "0",
 "continent_id": "3",
 "country_id": "9",
 "current_season_id": "10171",
 "current_round_id": "9518",
 "current_stage_id": null
 },
 {
 "id": "813",
 "name": "Girabola",
 "is_cup": "0",
 "is_amateur": "0",
 "continent_id": "3",
 "country_id": "11",
 "current_season_id": "9831",
 "current_round_id": "29480",
 "current_stage_id": null
 },
 {
 "id": "1134",
 "name": "Premier League",
 "is_cup": "0",
 "is_amateur": "0",
 "continent_id": "3",
 "country_id": "24",
 "current_season_id": "10167",
 "current_round_id": "9506",
 "current_stage_id": null
 },
 {
 "id": "1425",
 "name": "Elite One",
 "is_cup": "0",
 "is_amateur": "0",
 "continent_id": "3",
 "country_id": "27",
 "current_season_id": "8839",
 "current_round_id": "6053",
 "current_stage_id": null
 },
...

Test Endpoint

All Leagues by Country ID

The Get All Leagues Endpoint gives you all leagues of a specific country

GETAll Leagues by country ID

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringlist
country_idinteger{{COUNTRY_ID}}

Response

Response Example

                    {
 "data": [
 {
 "id": "592",
 "name": "2. Bundesliga",
 "is_cup": "0",
 "is_amateur": "0",
 "id_current_season": "613",
 "id_current_stage": null,
 "id_current_round": "2227",
 "continent": {
 "id": "2",
 "name": "Europe"
 },
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "de"
 },
 "seasons": [
 {
 "id": "613",
 "name": "19/20",
 "is_current": "1"
 },
 {
 "id": "614",
 "name": "18/19",
 "is_current": "0"
 }
 ]
 },
 {
 "id": "1855",
 "name": "2. Bundesliga Women",
 "is_cup": "0",
 "is_amateur": "1",
 "id_current_season": "9879",
 "id_current_stage": null,
 "id_current_round": "8325",
 "continent": {
 "id": "2",
 "name": "Europe"
 },
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "de"
 },
 "seasons": [
 {
 "id": "9879",
 "name": "19/20",
 "is_current": "1"
 },
 {
 "id": "9880",
 "name": "18/19",
 "is_current": "0"
 }
 ]
 },
 {
 "id": "593",
 "name": "3. Liga",
 "is_cup": "0",
 "is_amateur": "0",
 "id_current_season": "3223",
 "id_current_stage": null,
 "id_current_round": "3898",
 "continent": {
 "id": "2",
 "name": "Europe"
 },
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "de"
 },
 "seasons": [
 {
 "id": "3223",
 "name": "19/20",
 "is_current": "1"
 },
 {
 "id": "3224",
 "name": "18/19",
 "is_current": "0"
 }
 ]
 },
 {
 "id": "594",
 "name": "Bundesliga",
 "is_cup": "0",
 "is_amateur": "0",
 "id_current_season": "406",
 "id_current_stage": null,
 "id_current_round": "2019",
 "continent": {
 "id": "2",
 "name": "Europe"
 },
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "de"
 },
 "seasons": [
 {
 "id": "406",
 "name": "19/20",
 "is_current": "1"
 },
 {
 "id": "407",
 "name": "18/19",
 "is_current": "0"
 }
 ]
 },
 {
 "id": "1882",
 "name": "Bundesliga Women",
 "is_cup": "0",
 "is_amateur": "1",
 "id_current_season": "2027",
 "id_current_stage": null,
 "id_current_round": "3470",
 "continent": {
 "id": "2",
 "name": "Europe"
 },
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "de"
 },
 "seasons": [
 {
 "id": "2027",
 "name": "19/20",
 "is_current": "1"
 },
 {
 "id": "2028",
 "name": "18/19",
 "is_current": "0"
 }
 ]
 },
 {
 "id": "1863",
 "name": "DFB Junioren Pokal",
 "is_cup": "0",
 "is_amateur": "1",
 "id_current_season": "10371",
 "id_current_stage": null,
 "id_current_round": "10893",
 "continent": {
 "id": "2",
 "name": "Europe"
 },
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "de"
 },
 "seasons": [
 {
 "id": "10371",
 "name": "19/20",
 "is_current": "1"
 },
 {
 "id": "10372",
 "name": "18/19",
 "is_current": "0"
 }
 ]
 },
...

Test Endpoint

League by ID

The Get League by ID Endpoint gives you data from a specific League / tournament.

GETLeague by ID

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringinfo
idinteger{{LEAGUE_ID}}

Response

Response Example

                    {
 "data": {
 "id": "594",
 "name": "Bundesliga",
 "is_cup": "0",
 "is_amateur": "0",
 "id_current_season": "406",
 "id_current_stage": null,
 "id_current_round": "2019",
 "continent": {
 "id": "2",
 "name": "Europe"
 },
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "de"
 },
 "seasons": [
 {
 "id": "406",
 "name": "19/20",
 "is_current": "1"
 },
 {
 "id": "407",
 "name": "18/19",
 "is_current": "0"
 }
 ]
 },
...

Test Endpoint

League Standings

The Standings Endpoint show the rank of the teams of each League in which they are participating. The response of the Standings Endpoint can be returned in two formats.

GETLeague Standings by Season ID

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringstandings
season_idinteger{{SEASON_ID}}

Response

Response Example

                    {
 "data": {
 "league_id": "594",
 "season_id": "406",
 "stage_id": null,
 "round_id": null,
 "standings": [
 {
 "position": 1,
 "team_id": "111",
 "team_name": "B. Munich",
 "round": null,
 "group": null,
 "overall": {
 "games_played": 26,
 "won": 18,
 "draw": 4,
 "lost": 4,
 "goals_diff": 49,
 "goals_scored": 75,
 "goals_against": 26,
 "points": 58,
 "position": 1
 },
 "home": {
 "games_played": 13,
 "won": 9,
 "draw": 2,
 "lost": 2,
 "goals_diff": 27,
 "goals_scored": 38,
 "goals_against": 11,
 "points": 29,
 "position": 2
 },
 "away": {
 "games_played": 13,
 "won": 9,
 "draw": 2,
 "lost": 2,
 "goals_diff": 22,
 "goals_scored": 37,
 "goals_against": 15,
 "points": 29,
 "position": 1
 },
 "total": 26,
 "status": "Promotion",
 "result": "Champions League",
 "points": 58,
 "recent_form": null
 },
 {
 "position": 2,
 "team_id": "98",
 "team_name": "Dortmund",
 "round": null,
 "group": null,
 "overall": {
 "games_played": 27,
 "won": 17,
 "draw": 6,
 "lost": 4,
 "goals_diff": 41,
 "goals_scored": 74,
 "goals_against": 33,
 "points": 57,
 "position": 2
 },
 "home": {
 "games_played": 13,
 "won": 10,
 "draw": 3,
 "lost": 0,
 "goals_diff": 35,
 "goals_scored": 45,
 "goals_against": 10,
 "points": 33,
 "position": 1
 },
 "away": {
 "games_played": 14,
 "won": 7,
 "draw": 3,
 "lost": 4,
 "goals_diff": 6,
 "goals_scored": 29,
 "goals_against": 23,
 "points": 24,
 "position": 4
 },
 "total": 27,
 "status": "Promotion",
 "result": "Champions League",
 "points": 57,
 "recent_form": null
 },
 {
 "position": 3,
 "team_id": "114",
 "team_name": "Leverkusen",
 "round": null,
 "group": null,
 "overall": {
 "games_played": 27,
 "won": 16,
 "draw": 5,
 "lost": 6,
 "goals_diff": 20,
 "goals_scored": 52,
 "goals_against": 32,
 "points": 53,
 "position": 3
 },
 "home": {
 "games_played": 13,
 "won": 7,
 "draw": 4,
 "lost": 2,
 "goals_diff": 12,
 "goals_scored": 25,
 "goals_against": 13,
 "points": 25,
 "position": 5
 },
 "away": {
 "games_played": 14,
 "won": 9,
 "draw": 1,
 "lost": 4,
 "goals_diff": 8,
 "goals_scored": 27,
 "goals_against": 19,
 "points": 28,
 "position": 2
 },
 "total": 27,
 "status": "Promotion",
 "result": "Champions League",
 "points": 53,
 "recent_form": null
 },
 {
 "position": 4,
 "team_id": "2815",
 "team_name": "M´gladbach",
 "round": null,
 "group": null,
 "overall": {
 "games_played": 27,
 "won": 16,
 "draw": 4,
 "lost": 7,
 "goals_diff": 19,
 "goals_scored": 53,
 "goals_against": 34,
 "points": 52,
 "position": 4
 },
 "home": {
 "games_played": 14,
 "won": 9,
 "draw": 2,
 "lost": 3,
 "goals_diff": 12,
 "goals_scored": 31,
 "goals_against": 19,
 "points": 29,
 "position": 3
 },
 "away": {
 "games_played": 13,
 "won": 7,
 "draw": 2,
 "lost": 4,
 "goals_diff": 7,
 "goals_scored": 22,
 "goals_against": 15,
 "points": 23,
 "position": 5
 },
 "total": 27,
 "status": "Promotion",
 "result": "Champions League",
 "points": 52,
 "recent_form": null
 },
 {
 "position": 5,
 "team_id": "101",
 "team_name": "Leipzig",
 "round": null,
 "group": null,
 "overall": {
 "games_played": 26,
 "won": 14,
 "draw": 9,
 "lost": 3,
 "goals_diff": 36,
 "goals_scored": 63,
 "goals_against": 27,
 "points": 51,
 "position": 5
 },
 "home": {
 "games_played": 13,
 "won": 7,
 "draw": 5,
 "lost": 1,
 "goals_diff": 19,
 "goals_scored": 33,
 "goals_against": 14,
 "points": 26,
 "position": 4
 },
 "away": {
 "games_played": 13,
 "won": 7,
 "draw": 4,
 "lost": 2,
 "goals_diff": 17,
 "goals_scored": 30,
 "goals_against": 13,
 "points": 25,
 "position": 3
 },
 "total": 26,
 "status": "Promotion",
 "result": "Europa League",
 "points": 51,
 "recent_form": null
 },
 {
 "position": 6,
 "team_id": "2808",
 "team_name": "Wolfsburg",
 "round": null,
 "group": null,
 "overall": {
 "games_played": 27,
 "won": 10,
 "draw": 9,
 "lost": 8,
 "goals_diff": 3,
 "goals_scored": 36,
 "goals_against": 33,
 "points": 39,
 "position": 6
 },
 "home": {
 "games_played": 14,
 "won": 4,
 "draw": 6,
 "lost": 4,
 "goals_diff": 1,
 "goals_scored": 16,
 "goals_against": 15,
 "points": 18,
 "position": 12
 },
 "away": {
 "games_played": 13,
 "won": 6,
 "draw": 3,
 "lost": 4,
 "goals_diff": 2,
 "goals_scored": 20,
 "goals_against": 18,
 "points": 21,
 "position": 6
 },
 "total": 27,
 "status": "Promotion",
 "result": "Europa League Qualification",
 "points": 39,
 "recent_form": null
 },
 {
 "position": 7,
 "team_id": "2812",
 "team_name": "Freiburg",
 "round": null,
 "group": null,
 "overall": {
 "games_played": 27,
 "won": 10,
 "draw": 7,
 "lost": 10,
 "goals_diff": -2,
 "goals_scored": 35,
 "goals_against": 37,
 "points": 37,
 "position": 7
 },
 "home": {
 "games_played": 13,
 "won": 6,
 "draw": 2,
 "lost": 5,
 "goals_diff": 1,
 "goals_scored": 16,
 "goals_against": 15,
 "points": 20,
 "position": 9
 },
 "away": {
 "games_played": 14,
 "won": 4,
 "draw": 5,
 "lost": 5,
 "goals_diff": -3,
 "goals_scored": 19,
 "goals_against": 22,
 "points": 17,
 "position": 9
 },
 "total": 27,
 "status": "same",
 "result": null,
 "points": 37,
 "recent_form": null
 },
 {
 "position": 8,
 "team_id": "2816",
 "team_name": "Schalke",
 "round": null,
 "group": null,
 "overall": {
 "games_played": 26,
 "won": 9,
 "draw": 10,
 "lost": 7,
 "goals_diff": -7,
 "goals_scored": 33,
 "goals_against": 40,
 "points": 37,
 "position": 8
 },
 "home": {
 "games_played": 13,
 "won": 5,
 "draw": 6,
 "lost": 2,
 "goals_diff": 0,
 "goals_scored": 18,
 "goals_against": 18,
 "points": 21,
 "position": 7
 },
 "away": {
 "games_played": 13,
 "won": 4,
 "draw": 4,
 "lost": 5,
 "goals_diff": -7,
 "goals_scored": 15,
 "goals_against": 22,
 "points": 16,
 "position": 10
 },
 "total": 26,
 "status": "same",
 "result": null,
 "points": 37,
 "recent_form": null
 },
 {
 "position": 9,
 "team_id": "2818",
 "team_name": "Hoffenheim",
 "round": null,
 "group": null,
 "overall": {
 "games_played": 27,
 "won": 10,
 "draw": 6,
 "lost": 11,
 "goals_diff": -11,
 "goals_scored": 36,
 "goals_against": 47,
 "points": 36,
 "position": 9
 },
 "home": {
 "games_played": 14,
 "won": 5,
 "draw": 1,
 "lost": 8,
 "goals_diff": -15,
 "goals_scored": 19,
 "goals_against": 34,
 "points": 16,
 "position": 13
 },
 "away": {
 "games_played": 13,
 "won": 5,
 "draw": 5,
 "lost": 3,
 "goals_diff": 4,
 "goals_scored": 17,
 "goals_against": 13,
 "points": 20,
 "position": 7
 },
 "total": 27,
 "status": "same",
 "result": null,
 "points": 36,
 "recent_form": null
 },
 {
 "position": 10,
 "team_id": "2806",
 "team_name": "Hertha",
 "round": null,
 "group": null,
 "overall": {
 "games_played": 27,
 "won": 9,
 "draw": 7,
 "lost": 11,
 "goals_diff": -9,
 "goals_scored": 39,
 "goals_against": 48,
 "points": 34,
 "position": 10
 },
 "home": {
 "games_played": 14,
 "won": 4,
 "draw": 3,
 "lost": 7,
 "goals_diff": -10,
 "goals_scored": 18,
 "goals_against": 28,
 "points": 15,
 "position": 14
 },
...

Test Endpoint

Season by ID

The Season by ID Endpoint gives you info about a specific Season, like their league, their year, stages, rounds.

GETSeason By ID

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringinfo
idinteger{{SEASON_ID}}

Response

Response Example

                    {
 "data": {
 "id": "406",
 "name": "19/20",
 "is_current": "1",
 "league_id": "594",
 "current_round_id": "2019",
 "round_ids": [
 "255",
 "1994",
 "1995",
 "1996",
 "1997",
 "1998",
 "1999",
 "2000",
 "2001",
 "2002",
 "2003",
 "2004",
 "2005",
 "2006",
 "2007",
 "2008",
 "2009",
 "2010",
 "2011",
 "2012",
 "2013",
 "2014",
 "2015",
 "2016",
 "2017",
 "2018",
 "2019",
 "2020",
 "2021",
 "2022",
 "2023",
 "2024",
 "2025",
 "2026"
 ],
 "current_stage_id": null,
 "stages": null
 },
...

Test Endpoint

Stage by ID

The Stage by ID Endpoint gives you info about a specific Stage.

GETStage By ID

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringinfo
idinteger{{STAGE_ID}}

Response

Response Example

Test Endpoint

Stages by Season

The Stages by Season Endpoint returns the stages available for a specific season

GETStages by Season ID

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringbyseason
season_idinteger{{SEASON_ID}}

Response

Response Example

                     
{
 "data": [
 {
 "id": "1",
 "name": "Regular Season"
 },
 {
 "id": "2",
 "name": "Playoffs"
 },
...

Test Endpoint

Group by ID

The Group by ID Endpoint give you information of a specific Group

GETGroup By ID

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringinfo
idinteger{{GROUP_ID}}

Response

Response Example

                    {
 "data": {
 "id": "5",
 "name": "Group A"
 },
...

Test Endpoint

Rounds by Season

The Rounds by Season ID endpoint returns a list of Rounds of a single season

GETRounds by Season ID

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringbyseason
season_idinteger{{SEASON_ID}}

Response

Response Example

                    {
 "data": [
 {
 "id": "1994",
 "name": "1",
 "league_id": "594",
 "season_id": "406",
 "is_current": null
 },
 {
 "id": "1995",
 "name": "2",
 "league_id": "594",
 "season_id": "406",
 "is_current": null
 },
 {
 "id": "1996",
 "name": "3",
 "league_id": "594",
 "season_id": "406",
 "is_current": null
 },
 {
 "id": "1997",
 "name": "4",
 "league_id": "594",
 "season_id": "406",
 "is_current": null
 },
 {
 "id": "1998",
 "name": "5",
 "league_id": "594",
 "season_id": "406",
 "is_current": null
 },
 {
 "id": "1999",
 "name": "6",
 "league_id": "594",
 "season_id": "406",
 "is_current": null
 },
 {
 "id": "2000",
 "name": "7",
 "league_id": "594",
 "season_id": "406",
 "is_current": null
 },
 {
 "id": "2001",
 "name": "8",
 "league_id": "594",
 "season_id": "406",
 "is_current": null
 },
 {
 "id": "2002",
 "name": "9",
 "league_id": "594",
 "season_id": "406",
 "is_current": null
 },
 {
 "id": "2003",
 "name": "10",
 "league_id": "594",
 "season_id": "406",
 "is_current": null
 },
 {
 "id": "2004",
 "name": "11",
 "league_id": "594",
 "season_id": "406",
 "is_current": null
 },
 {
 "id": "2005",
 "name": "12",
 "league_id": "594",
 "season_id": "406",
 "is_current": null
 },
 {
 "id": "2006",
 "name": "13",
 "league_id": "594",
 "season_id": "406",
 "is_current": null
 },
 {
 "id": "2007",
 "name": "14",
 "league_id": "594",
 "season_id": "406",
 "is_current": null
 },
...

Test Endpoint

Round by ID

The Round by ID endpoint returns information of a single round

GETRound By ID

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringinfo
idinteger{{ROUND_ID}}

Response

Response Example

                    {
 "data": {
 "id": "2005",
 "name": "12",
 "league_id": "594",
 "season_id": "406",
 "is_current": null
 },
...

Test Endpoint

Teams by Country

The Teams by Country ID endpoint returns a list of teams from a specific country

GETTeams by Country ID

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringlist
country_idinteger{{COUNTRY_ID}}

Response

Response Example

                    {
 "data": [
 {
 "id": "98",
 "name": "Borussia Dortmund",
 "country_id": "4"
 },
 {
 "id": "101",
 "name": "RB Leipzig",
 "country_id": "4"
 },
 {
 "id": "111",
 "name": "FC Bayern Munich",
 "country_id": "4"
 },
 {
 "id": "114",
 "name": "Bayer 04 Leverkusen",
 "country_id": "4"
 },
 {
 "id": "1108",
 "name": "1. Goppinger SV",
 "country_id": "4"
 },
 {
 "id": "1109",
 "name": "FC 08 Villingen",
 "country_id": "4"
 },
 {
 "id": "1110",
 "name": "FV Ravensburg",
 "country_id": "4"
 },
 {
 "id": "1111",
 "name": "Stuttgarter Kickers",
 "country_id": "4"
 },
 {
 "id": "1112",
 "name": "SSV Reutlingen 1905",
 "country_id": "4"
 },
 {
 "id": "1113",
 "name": "SV Oberachern",
 "country_id": "4"
 },
 {
 "id": "1114",
 "name": "FSV 08 Bissingen",
 "country_id": "4"
 },
 {
 "id": "1115",
 "name": "SV Sandhausen II",
 "country_id": "4"
 },
 {
 "id": "1116",
 "name": "Neckarsulm",
 "country_id": "4"
 },
 {
 "id": "1119",
 "name": "SGV Freiberg",
 "country_id": "4"
 },
 {
 "id": "1120",
 "name": "VfB Stuttgart II",
 "country_id": "4"
 },
 {
 "id": "1121",
 "name": "FC Nottingen",
 "country_id": "4"
 },
 {
 "id": "1122",
 "name": "Freiburger FC",
 "country_id": "4"
 },
 {
 "id": "1123",
 "name": "1. FC Pforzheim 1896",
 "country_id": "4"
 },
 {
 "id": "1124",
 "name": "1. FC Rielasingen-Arlen",
 "country_id": "4"
 },
 {
 "id": "1128",
 "name": "FC Strausberg",
 "country_id": "4"
 },
...

Test Endpoint

Teams by Season

The Teams by Season ID endpoint returns a list of teams participants on a single season

GETTeams by Season ID

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringbyseason
season_idinteger{{SEASON_ID}}

Response

Response Example

                    {
 "data": [
 {
 "id": "111",
 "name": "B. Munich",
 "country_id": "4"
 },
 {
 "id": "101",
 "name": "Leipzig",
 "country_id": "4"
 },
 {
 "id": "98",
 "name": "Dortmund",
 "country_id": "4"
 },
 {
 "id": "2815",
 "name": "M´gladbach",
 "country_id": "4"
 },
 {
 "id": "114",
 "name": "Leverkusen",
 "country_id": "4"
 },
 {
 "id": "2816",
 "name": "Schalke",
 "country_id": "4"
 },
 {
 "id": "2808",
 "name": "Wolfsburg",
 "country_id": "4"
 },
 {
 "id": "2818",
 "name": "Hoffenheim",
 "country_id": "4"
 },
 {
 "id": "2812",
 "name": "Freiburg",
 "country_id": "4"
 },
 {
 "id": "2819",
 "name": "Union Berlin",
 "country_id": "4"
 },
 {
 "id": "2817",
 "name": "Frankfurt",
 "country_id": "4"
 },
 {
 "id": "2814",
 "name": "Augsburg",
 "country_id": "4"
 },
 {
 "id": "2809",
 "name": "Cologne",
 "country_id": "4"
 },
 {
 "id": "2806",
 "name": "Hertha",
 "country_id": "4"
 },
...

Test Endpoint

Teams National

The Teams National endpoint returns a list of national soccer teams

GETNational Teams

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringnational

Response

Response Example

                     
...

Test Endpoint

Team by ID

The Team Info endpoint gives you data of a specific team.

GETTeam By Id

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringinfo
idinteger{{TEAM_ID}}

Response

Response Example

                    {
 "data": {
 "id": "111",
 "common_name": "Bayern Munich",
 "name": "FC Bayern Munich",
 "short_code": "FCB",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/100/111.png",
 "leagues": [
 {
 "id": "594",
 "name": "Bundesliga",
 "current_season_id": "7199"
 },
 {
 "id": "595",
 "name": "DFB Pokal",
 "current_season_id": "7237"
 },
 {
 "id": "3700",
 "name": "MLS All Star Game",
 "current_season_id": "9683"
 },
 {
 "id": "539",
 "name": "UEFA Champions League",
 "current_season_id": "45"
 },
 {
 "id": "542",
 "name": "UEFA Super Cup",
 "current_season_id": "7291"
 },
 {
 "id": "596",
 "name": "Super Cup",
 "current_season_id": "7253"
 }
 ],
 "founded": "1900",
 "twitter": "",
 "coach_id": "662",
 "venue_id": "1446",
 "kit": {
 "home_main_color": "#e60000",
 "home_second_color": "#e00000",
 "home_number_color": "#ffffff",
 "away_main_color": "#ffffff",
 "away_second_color": "#ffffff",
 "away_number_color": "#ff4d00",
 "away2_main_color": "#000061",
 "away2_second_color": "#ff8800",
 "away2_number_color": "#ff7300",
 "goalkeeper_main_color": "#cccccc",
 "goalkeeper_second_color": "#33ccff",
 "goalkeeper_number_color": "#ffffff"
 },
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "de"
 }
 },
...

Test Endpoint

Team Squad

The Team Squad endpoint gives you all players of a specific team of the current season.

GETSquad by Team ID

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringsquad
idinteger{{TEAM_ID}}

Response

Response Example

                    {
 "data": {
 "formation": null,
 "squad": [
 {
 "player": {
 "id": "17322",
 "name": null,
 "common_name": "Neuer, Manuel",
 "firstname": "Manuel Peter",
 "lastname": "Neuer",
 "weight": "92",
 "height": "193",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/17322.png",
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "de"
 }
 },
 "number": "1",
 "captain": null,
 "position": "G",
 "order": null
 },
 {
 "player": {
 "id": "17331",
 "name": null,
 "common_name": "Martinez, Javi",
 "firstname": "Javier",
 "lastname": "Martinez Aguinaga",
 "weight": "86",
 "height": "192",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/17331.png",
 "country": {
 "id": "5",
 "name": "Spain",
 "cc": "es"
 }
 },
 "number": "8",
 "captain": null,
 "position": "D",
 "order": null
 },
 {
 "player": {
 "id": "17324",
 "name": null,
 "common_name": "Boateng, Jerome",
 "firstname": "Jerome Agyenim",
 "lastname": "Boateng",
 "weight": "90",
 "height": "192",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/17324.png",
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "de"
 }
 },
 "number": "17",
 "captain": null,
 "position": "D",
 "order": null
 },
 {
 "player": {
 "id": "17330",
 "name": null,
 "common_name": "Ulreich, Sven",
 "firstname": "Sven",
 "lastname": "Ulreich",
 "weight": "87",
 "height": "192",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/17330.png",
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "de"
 }
 },
 "number": "26",
 "captain": null,
 "position": "G",
 "order": null
 },
 {
 "player": {
 "id": "17327",
 "name": null,
 "common_name": "Muller, Thomas",
 "firstname": "Thomas",
 "lastname": "Muller",
 "weight": "75",
 "height": "186",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/17327.png",
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "de"
 }
 },
 "number": "25",
 "captain": null,
 "position": "F",
 "order": null
 },
 {
 "player": {
 "id": "19994",
 "name": null,
 "common_name": "Perisic, Ivan",
 "firstname": "Ivan",
 "lastname": "Perisic",
 "weight": "81",
 "height": "186",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/19994.png",
 "country": {
 "id": "34",
 "name": "Croatia",
 "cc": "hr"
 }
 },
 "number": "14",
 "captain": null,
 "position": "M",
 "order": null
 },
 {
 "player": {
 "id": "19988",
 "name": null,
 "common_name": "Lewandowski, Robert",
 "firstname": "Robert",
 "lastname": "Lewandowski",
 "weight": "79",
 "height": "185",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/19988.png",
 "country": {
 "id": "95",
 "name": "Poland",
 "cc": "pl"
 }
 },
 "number": "9",
 "captain": null,
 "position": "F",
 "order": null
 },
 {
 "player": {
 "id": "17328",
 "name": null,
 "common_name": "Alcantara, Thiago",
 "firstname": "Thiago",
 "lastname": "Alcantara do Nascimento",
 "weight": "70",
 "height": "174",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/17328.png",
 "country": {
 "id": "5",
 "name": "Spain",
 "cc": "es"
 }
 },
 "number": "6",
 "captain": null,
 "position": "M",
 "order": null
 },
 {
 "player": {
 "id": "17325",
 "name": null,
 "common_name": "Alaba, David",
 "firstname": "David",
 "lastname": "Alaba",
 "weight": "78",
 "height": "180",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/17325.png",
 "country": {
 "id": "15",
 "name": "Austria",
 "cc": "at"
 }
 },
 "number": "27",
 "captain": null,
 "position": "D",
 "order": null
 },
 {
 "player": {
 "id": "17329",
 "name": null,
 "common_name": "Coutinho, Philippe",
 "firstname": "Philippe",
 "lastname": "Coutinho Correia",
 "weight": "68",
 "height": "172",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/17329.png",
 "country": {
 "id": "25",
 "name": "Brazil",
 "cc": "br"
 }
 },
 "number": "10",
 "captain": null,
 "position": "M",
 "order": null
 },
 {
 "player": {
 "id": "23895",
 "name": null,
 "common_name": "Sule, Niklas",
 "firstname": "Niklas",
 "lastname": "Sule",
 "weight": null,
 "height": null,
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/23895.png",
 "country": {
 "id": null,
 "name": null,
 "cc": null
 }
 },
 "number": "4",
 "captain": null,
 "position": "D",
 "order": null
 },
 {
 "player": {
 "id": "14514",
 "name": null,
 "common_name": "Wriedt, Kwasi Okyere",
 "firstname": "Kwasi Okyere",
 "lastname": "Wriedt",
 "weight": "82",
 "height": "188",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/14514.png",
 "country": {
 "id": "48",
 "name": "Ghana",
 "cc": "gh"
 }
 },
 "number": "38",
 "captain": null,
 "position": "F",
 "order": null
 },
...

Test Endpoint

Team Squad by Season

The Team Squad current season endpoint gives you all players of a specific team from a specific season.

GETSquad By Team Id ans Season ID

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringsquad
idinteger{{TEAM_ID}}
season_idinteger{{SEASON_ID}}

Response

Response Example

                    {
 "data": {
 "formation": null,
 "squad": [
 {
 "player": {
 "id": "17322",
 "name": null,
 "common_name": "Neuer, Manuel",
 "firstname": "Manuel Peter",
 "lastname": "Neuer",
 "weight": "92",
 "height": "193",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/17322.png",
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "de"
 }
 },
 "number": "1",
 "captain": null,
 "position": "G",
 "order": null
 },
 {
 "player": {
 "id": "17331",
 "name": null,
 "common_name": "Martinez, Javi",
 "firstname": "Javier",
 "lastname": "Martinez Aguinaga",
 "weight": "86",
 "height": "192",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/17331.png",
 "country": {
 "id": "5",
 "name": "Spain",
 "cc": "es"
 }
 },
 "number": "8",
 "captain": null,
 "position": "D",
 "order": null
 },
 {
 "player": {
 "id": "17324",
 "name": null,
 "common_name": "Boateng, Jerome",
 "firstname": "Jerome Agyenim",
 "lastname": "Boateng",
 "weight": "90",
 "height": "192",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/17324.png",
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "de"
 }
 },
 "number": "17",
 "captain": null,
 "position": "D",
 "order": null
 },
 {
 "player": {
 "id": "17330",
 "name": null,
 "common_name": "Ulreich, Sven",
 "firstname": "Sven",
 "lastname": "Ulreich",
 "weight": "87",
 "height": "192",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/17330.png",
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "de"
 }
 },
 "number": "26",
 "captain": null,
 "position": "G",
 "order": null
 },
 {
 "player": {
 "id": "17327",
 "name": null,
 "common_name": "Muller, Thomas",
 "firstname": "Thomas",
 "lastname": "Muller",
 "weight": "75",
 "height": "186",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/17327.png",
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "de"
 }
 },
 "number": "25",
 "captain": null,
 "position": "F",
 "order": null
 },
 {
 "player": {
 "id": "19994",
 "name": null,
 "common_name": "Perisic, Ivan",
 "firstname": "Ivan",
 "lastname": "Perisic",
 "weight": "81",
 "height": "186",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/19994.png",
 "country": {
 "id": "34",
 "name": "Croatia",
 "cc": "hr"
 }
 },
 "number": "14",
 "captain": null,
 "position": "M",
 "order": null
 },
 {
 "player": {
 "id": "19988",
 "name": null,
 "common_name": "Lewandowski, Robert",
 "firstname": "Robert",
 "lastname": "Lewandowski",
 "weight": "79",
 "height": "185",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/19988.png",
 "country": {
 "id": "95",
 "name": "Poland",
 "cc": "pl"
 }
 },
 "number": "9",
 "captain": null,
 "position": "F",
 "order": null
 },
 {
 "player": {
 "id": "17328",
 "name": null,
 "common_name": "Alcantara, Thiago",
 "firstname": "Thiago",
 "lastname": "Alcantara do Nascimento",
 "weight": "70",
 "height": "174",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/17328.png",
 "country": {
 "id": "5",
 "name": "Spain",
 "cc": "es"
 }
 },
 "number": "6",
 "captain": null,
 "position": "M",
 "order": null
 },
 {
 "player": {
 "id": "17325",
 "name": null,
 "common_name": "Alaba, David",
 "firstname": "David",
 "lastname": "Alaba",
 "weight": "78",
 "height": "180",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/17325.png",
 "country": {
 "id": "15",
 "name": "Austria",
 "cc": "at"
 }
 },
 "number": "27",
 "captain": null,
 "position": "D",
 "order": null
 },
 {
 "player": {
 "id": "17329",
 "name": null,
 "common_name": "Coutinho, Philippe",
 "firstname": "Philippe",
 "lastname": "Coutinho Correia",
 "weight": "68",
 "height": "172",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/17329.png",
 "country": {
 "id": "25",
 "name": "Brazil",
 "cc": "br"
 }
 },
 "number": "10",
 "captain": null,
 "position": "M",
 "order": null
 },
 {
 "player": {
 "id": "23895",
 "name": null,
 "common_name": "Sule, Niklas",
 "firstname": "Niklas",
 "lastname": "Sule",
 "weight": null,
 "height": null,
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/23895.png",
 "country": {
 "id": null,
 "name": null,
 "cc": null
 }
 },
 "number": "4",
 "captain": null,
 "position": "D",
 "order": null
 },
 {
 "player": {
 "id": "14514",
 "name": null,
 "common_name": "Wriedt, Kwasi Okyere",
 "firstname": "Kwasi Okyere",
 "lastname": "Wriedt",
 "weight": "82",
 "height": "188",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/14514.png",
 "country": {
 "id": "48",
 "name": "Ghana",
 "cc": "gh"
 }
 },
 "number": "38",
 "captain": null,
 "position": "F",
 "order": null
 },
...

Test Endpoint

Team Transfers

The Team Transfers endpoint returns the transfers (IN, OUT) of a specific team

GETTransfers By Team Id

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringtransfers
idinteger{{TEAM_ID}}

Response

Response Example

                    {
 "data": {
 "arrivals": [
 {
 "player": {
 "id": null,
 "name": "Lucas Hernández"
 },
 "team_left": {
 "id": "107",
 "name": "Atletico Madrid"
 },
 "type": null,
 "date": null,
 "fee": "$88.00m"
 },
 {
 "player": {
 "id": null,
 "name": "Benjamin Pavard"
 },
 "team_left": {
 "id": "2849",
 "name": "VfB Stuttgart"
 },
 "type": null,
 "date": null,
 "fee": "$38.50m"
 },
 {
 "player": {
 "id": null,
 "name": "Michaël Cuisance"
 },
 "team_left": {
 "id": "2815",
 "name": "Borussia Monchengladbach"
 },
 "type": null,
 "date": null,
 "fee": "$13.20m"
 },
 
...

Test Endpoint

Team Sidelined

The Team Sidelined endpoint return data about injured or missing players.

GETSidelined By Team ID

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringsidelined
idinteger{{TEAM_ID}}

Response

Response Example

                    {
 "data": {
 "id": "111",
 "name": "Bayern Munich",
 "types": {
 "injuries": [
 {
 "player": {
 "id": "8329",
 "name": "Tolisso, Corentin"
 },
 "reason": "Ankle Surgery",
 "since": "2020-04-20",
 "expected_return": "2020-06-30"
 },
 {
 "player": {
 "id": "17329",
 "name": "Coutinho, Philippe"
 },
 "reason": "Ankle problems",
 "since": "2020-04-24",
 "expected_return": "2020-06-07"
 },
 {
 "player": {
 "id": "23895",
 "name": "Sule, Niklas"
 },
 "reason": "Fitness",
 "since": "2020-05-18",
 "expected_return": "2020-05-31"
 }
 ]
 }
 },
...

Test Endpoint

Team Trophies

The Team Trophies endpoint returns data about how many and which trophies has won the specified team along his history.

GETTrophies By Team Id

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringtrophies
idinteger{{TEAM_ID}}

Response

Response Example

                    {
 "data": {
 "season_id": "111",
 "trophies": [
 {
 "id": 19,
 "name": "German Supercup Runner Up",
 "seasons": [
 "19/20",
 "15/16",
 "14/15",
 "13/14",
 "94/95",
 "89/90"
 ]
 },
 {
 "id": 20,
 "name": "Champions League Participant",
 "seasons": [
 "19/20",
 "18/19",
 "17/18",
 "16/17",
 "15/16",
 "14/15",
 "13/14",
 "12/13",
 "11/12",
 "10/11",
...

Test Endpoint

Livescores Today

The Livescores today Endpoint gives you a list of matches will play today. (From the leagues available in your plan)

GETToday Matches

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringtoday

Response

Response Example

                     
{
 "data": [
 {
 "id": "21294795",
 "status": "3",
 "status_name": "Finished",
 "status_period": null,
 "pitch": null,
 "referee_id": null,
 "round_id": "30333",
 "season_id": "17170743",
 "season_name": "2020",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": null,
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2020-05-20 00:15:00",
 "date": "2020-05-20",
 "time": "00:15:00",
 "minute": 90,
 "timestamp": 1589926500,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "18966",
 "name": "Colo Colo SRL",
 "short_code": "COC",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/18966.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "18967",
 "name": "Penarol Montevideo SRL",
 "short_code": "PEN",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/18967.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": null,
 "name": null,
 "type": "Copa Libertadores SRL",
 "country_id": null,
 "country_name": null,
 "country_flag": null
 },
 "scores": {
 "home_score": "2",
 "away_score": "0",
 "ht_score": "1-0",
 "ft_score": "2-0",
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0"
 },
 "weather_report": false
 },
 {
 "id": "21294798",
 "status": "3",
 "status_name": "Finished",
 "status_period": null,
 "pitch": null,
 "referee_id": null,
 "round_id": "30333",
 "season_id": "17170743",
 "season_name": "2020",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": null,
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2020-05-20 00:15:00",
 "date": "2020-05-20",
 "time": "00:15:00",
 "minute": 90,
 "timestamp": 1589926500,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "18968",
 "name": "Defensa Justicia SRL",
 "short_code": "DEF",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/18968.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "18969",
 "name": "Delfin SC SRL",
 "short_code": "DEL",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/18969.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": null,
 "name": null,
 "type": "Copa Libertadores SRL",
 "country_id": null,
 "country_name": null,
 "country_flag": null
 },
 "scores": {
 "home_score": "3",
 "away_score": "0",
 "ht_score": "1-0",
 "ft_score": "3-0",
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0"
 },
 "weather_report": false
 },
 {
 "id": "21294802",
 "status": "3",
 "status_name": "Finished",
 "status_period": null,
 "pitch": null,
 "referee_id": null,
 "round_id": "30333",
 "season_id": "17170743",
 "season_name": "2020",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": null,
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2020-05-20 00:15:00",
 "date": "2020-05-20",
 "time": "00:15:00",
 "minute": 90,
 "timestamp": 1589926500,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "18970",
 "name": "Jorge Wilstermann SRL",
 "short_code": "WIL",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/18970.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "18971",
 "name": "CA Paranaense PR SRL",
 "short_code": "PAR",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/18971.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": null,
 "name": null,
 "type": "Copa Libertadores SRL",
 "country_id": null,
 "country_name": null,
 "country_flag": null
 },
 "scores": {
 "home_score": "0",
 "away_score": "1",
 "ht_score": "0-0",
 "ft_score": "0-1",
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0"
 },
 "weather_report": false
 },
 ...

Test Endpoint

Livescores Tomorrow

The Livescores Tomorrow Endpoint gives you a list of matches will play tomorrow. (From the leagues available in your plan)

GETTomorrow Matches

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringtomorrow

Response

Response Example

                     {
 "data": [
 {
 "id": "21498371",
 "status": 0,
 "status_name": "Notstarted",
 "status_period": null,
 "pitch": null,
 "referee_id": null,
 "round_id": null,
 "season_id": "17170743",
 "season_name": "2020",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": null,
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2020-05-21 00:15:00",
 "date": "2020-05-21",
 "time": "00:15:00",
 "minute": null,
 "timestamp": 1590012900,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "18978",
 "name": "Estudiantes de Merida SRL",
 "short_code": "MER",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/18978.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "18979",
 "name": "Alianza Lima SRL",
 "short_code": "ALI",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/18979.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": null,
 "name": null,
 "type": "Copa Libertadores SRL",
 "country_id": null,
 "country_name": null,
 "country_flag": null
 },
 "scores": {
 "home_score": null,
 "away_score": null,
 "ht_score": null,
 "ft_score": null,
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0"
 },
 "weather_report": false
 },
 {
 "id": "21498374",
 "status": 0,
 "status_name": "Notstarted",
 "status_period": null,
 "pitch": null,
 "referee_id": null,
 "round_id": null,
 "season_id": "17170743",
 "season_name": "2020",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": null,
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2020-05-21 00:15:00",
 "date": "2020-05-21",
 "time": "00:15:00",
 "minute": null,
 "timestamp": 1590012900,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "18980",
 "name": "Racing Club Avellaneda SRL",
 "short_code": "AVE",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/18980.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "18981",
 "name": "Club Nacional de Football SRL",
 "short_code": "NAC",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/18981.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": null,
 "name": null,
 "type": "Copa Libertadores SRL",
 "country_id": null,
 "country_name": null,
 "country_flag": null
 },
 "scores": {
 "home_score": null,
 "away_score": null,
 "ht_score": null,
 "ft_score": null,
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0"
 },
 "weather_report": false
 },
 {
 "id": "21498375",
 "status": 0,
 "status_name": "Notstarted",
 "status_period": null,
 "pitch": null,
 "referee_id": null,
 "round_id": null,
 "season_id": "17170743",
 "season_name": "2020",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": null,
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2020-05-21 00:15:00",
 "date": "2020-05-21",
 "time": "00:15:00",
 "minute": null,
 "timestamp": 1590012900,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "18982",
 "name": "SC Internacional RS SRL",
 "short_code": "INT",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/18982.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "18983",
 "name": "America de Cali SRL",
 "short_code": "AME",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/18983.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": null,
 "name": null,
 "type": "Copa Libertadores SRL",
 "country_id": null,
 "country_name": null,
 "country_flag": null
 },
 "scores": {
 "home_score": null,
 "away_score": null,
 "ht_score": null,
 "ft_score": null,
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0"
 },
 "weather_report": false
 },
 {
 "id": "21528970",
 "status": 0,
 "status_name": "Notstarted",
 "status_period": null,
 "pitch": null,
 "referee_id": null,
 "round_id": null,
 "season_id": "17170743",
 "season_name": "2020",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": null,
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2020-05-21 02:30:00",
 "date": "2020-05-21",
 "time": "02:30:00",
 "minute": null,
 "timestamp": 1590021000,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "18984",
 "name": "CD Universidad Catolica SRL",
 "short_code": "CAT",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/18984.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "18985",
 "name": "Gremio FB Porto Alegrense RS SRL",
 "short_code": "GRE",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/18985.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": null,
 "name": null,
 "type": "Copa Libertadores SRL",
 "country_id": null,
 "country_name": null,
 "country_flag": null
 },
 "scores": {
 "home_score": null,
 "away_score": null,
 "ht_score": null,
 "ft_score": null,
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0"
 },
 "weather_report": false
 },
 {
 "id": "21528972",
 "status": 0,
 "status_name": "Notstarted",
 "status_period": null,
 "pitch": null,
 "referee_id": null,
 "round_id": null,
 "season_id": "17170743",
 "season_name": "2020",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": null,
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2020-05-21 02:30:00",
 "date": "2020-05-21",
 "time": "02:30:00",
 "minute": null,
 "timestamp": 1590021000,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "18986",
 "name": "Club Bolivar SRL",
 "short_code": "BOL",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/18986.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "18987",
 "name": "SE Palmeiras SP SRL",
 "short_code": "PAL",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/18987.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": null,
 "name": null,
 "type": "Copa Libertadores SRL",
 "country_id": null,
 "country_name": null,
 "country_flag": null
 },
 "scores": {
 "home_score": null,
 "away_score": null,
 "ht_score": null,
 "ft_score": null,
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0"
 },
 "weather_report": false
 },
 {
 "id": "21528975",
 "status": 0,
 "status_name": "Notstarted",
 "status_period": null,
 "pitch": null,
 "referee_id": null,
 "round_id": null,
 "season_id": "17170743",
 "season_name": "2020",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": null,
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2020-05-21 02:30:00",
 "date": "2020-05-21",
 "time": "02:30:00",
 "minute": null,
 "timestamp": 1590021000,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "18988",
 "name": "Independiente Medellin SRL",
 "short_code": "MED",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/18988.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "18989",
 "name": "Caracas FC SRL",
 "short_code": "CAR",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/18989.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": null,
 "name": null,
 "type": "Copa Libertadores SRL",
 "country_id": null,
 "country_name": null,
 "country_flag": null
 },
 "scores": {
 "home_score": null,
 "away_score": null,
 "ht_score": null,
 "ft_score": null,
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0"
 },
 "weather_report": false
 },
...

Test Endpoint

Livescores Yesterday

The Livescores Yesterday Endpoint gives you a list of matches has play yesterday. (From the leagues available in your plan)

GETYesterday Matches

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringyesterday

Response

Response Example

                    {
 "data": [
 {
 "id": "21498371",
 "status": 0,
 "status_name": "Notstarted",
 "status_period": null,
 "pitch": null,
 "referee_id": null,
 "round_id": null,
 "season_id": "17170743",
 "season_name": "2020",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": null,
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2020-05-21 00:15:00",
 "date": "2020-05-21",
 "time": "00:15:00",
 "minute": null,
 "timestamp": 1590012900,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "18978",
 "name": "Estudiantes de Merida SRL",
 "short_code": "MER",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/18978.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "18979",
 "name": "Alianza Lima SRL",
 "short_code": "ALI",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/18979.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": null,
 "name": null,
 "type": "Copa Libertadores SRL",
 "country_id": null,
 "country_name": null,
 "country_flag": null
 },
 "scores": {
 "home_score": null,
 "away_score": null,
 "ht_score": null,
 "ft_score": null,
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0"
 },
 "weather_report": false
 },
 {
 "id": "21498374",
 "status": 0,
 "status_name": "Notstarted",
 "status_period": null,
 "pitch": null,
 "referee_id": null,
 "round_id": null,
 "season_id": "17170743",
 "season_name": "2020",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": null,
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2020-05-21 00:15:00",
 "date": "2020-05-21",
 "time": "00:15:00",
 "minute": null,
 "timestamp": 1590012900,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "18980",
 "name": "Racing Club Avellaneda SRL",
 "short_code": "AVE",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/18980.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "18981",
 "name": "Club Nacional de Football SRL",
 "short_code": "NAC",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/18981.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": null,
 "name": null,
 "type": "Copa Libertadores SRL",
 "country_id": null,
 "country_name": null,
 "country_flag": null
 },
 "scores": {
 "home_score": null,
 "away_score": null,
 "ht_score": null,
 "ft_score": null,
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0"
 },
 "weather_report": false
 },
 {
 "id": "21498375",
 "status": 0,
 "status_name": "Notstarted",
 "status_period": null,
 "pitch": null,
 "referee_id": null,
 "round_id": null,
 "season_id": "17170743",
 "season_name": "2020",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": null,
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2020-05-21 00:15:00",
 "date": "2020-05-21",
 "time": "00:15:00",
 "minute": null,
 "timestamp": 1590012900,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "18982",
 "name": "SC Internacional RS SRL",
 "short_code": "INT",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/18982.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "18983",
 "name": "America de Cali SRL",
 "short_code": "AME",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/18983.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": null,
 "name": null,
 "type": "Copa Libertadores SRL",
 "country_id": null,
 "country_name": null,
 "country_flag": null
 },
 "scores": {
 "home_score": null,
 "away_score": null,
 "ht_score": null,
 "ft_score": null,
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0"
 },
 "weather_report": false
 },
 {
 "id": "21528970",
 "status": 0,
 "status_name": "Notstarted",
 "status_period": null,
 "pitch": null,
 "referee_id": null,
 "round_id": null,
 "season_id": "17170743",
 "season_name": "2020",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": null,
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2020-05-21 02:30:00",
 "date": "2020-05-21",
 "time": "02:30:00",
 "minute": null,
 "timestamp": 1590021000,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "18984",
 "name": "CD Universidad Catolica SRL",
 "short_code": "CAT",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/18984.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "18985",
 "name": "Gremio FB Porto Alegrense RS SRL",
 "short_code": "GRE",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/18985.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": null,
 "name": null,
 "type": "Copa Libertadores SRL",
 "country_id": null,
 "country_name": null,
 "country_flag": null
 },
 "scores": {
 "home_score": null,
 "away_score": null,
 "ht_score": null,
 "ft_score": null,
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0"
 },
 "weather_report": false
 },
 {
 "id": "21528972",
 "status": 0,
 "status_name": "Notstarted",
 "status_period": null,
 "pitch": null,
 "referee_id": null,
 "round_id": null,
 "season_id": "17170743",
 "season_name": "2020",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": null,
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2020-05-21 02:30:00",
 "date": "2020-05-21",
 "time": "02:30:00",
 "minute": null,
 "timestamp": 1590021000,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "18986",
 "name": "Club Bolivar SRL",
 "short_code": "BOL",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/18986.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "18987",
 "name": "SE Palmeiras SP SRL",
 "short_code": "PAL",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/18987.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": null,
 "name": null,
 "type": "Copa Libertadores SRL",
 "country_id": null,
 "country_name": null,
 "country_flag": null
 },
 "scores": {
 "home_score": null,
 "away_score": null,
 "ht_score": null,
 "ft_score": null,
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0"
 },
 "weather_report": false
 },
...

Test Endpoint

Livescores Inplay

The Livescores Inplay Endpoint gives you a list of matches playing now. (From the leagues available in your plan)

GETInplay Matches

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringlive

Response

Response Example

                    {
 "data": [
 {
 "id": "21489676",
 "status": 1,
 "status_name": "Inplay",
 "status_period": "1st Half",
 "pitch": null,
 "referee_id": null,
 "round_id": "29445",
 "season_id": "8579",
 "season_name": "2020",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": "569",
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2020-05-20 16:00:00",
 "date": "2020-05-20",
 "time": "16:00:00",
 "minute": "20",
 "timestamp": 1589983200,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "1651",
 "name": "SK Dynamo Ceske Budejovice",
 "short_code": "BUD",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/1651.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "76",
 "name": "FC Viktoria Plzen",
 "short_code": "VIK",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/76.png",
 "form": null,
 "coach_id": "2350",
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": "520",
 "name": "Club Friendly",
 "type": "",
 "country_id": "2",
 "country_name": "International Clubs",
 "country_flag": "https://cdn.soccersapi.com/images/countries/30/.png"
 },
 "scores": {
 "home_score": "1",
 "away_score": "1",
 "ht_score": "",
 "ft_score": "1-1",
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": "",
 "away_position": ""
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0"
 },
 "weather_report": false
 }
 ],
...

Test Endpoint

Livescores Not Started

The Livescores Not Started Endpoint gives you a list of matches will play today and haven't started yet. (From the leagues available in your plan)

GETNot Started Matches

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringnotstarted

Response

Response Example

                    {
 "data": [
 {
 "id": "21489766",
 "status": 0,
 "status_name": "Notstarted",
 "status_period": null,
 "pitch": null,
 "referee_id": null,
 "round_id": "30333",
 "season_id": "4600482",
 "season_name": "19/20",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": null,
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2020-05-20 21:00:00",
 "date": "2020-05-20",
 "time": "21:00:00",
 "minute": 90,
 "timestamp": 1590001200,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "18699",
 "name": "FC Bayern Munich SRL",
 "short_code": "FCB",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/18699.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "18797",
 "name": "Olympique Lyonnais",
 "short_code": "OL",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/18797.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": null,
 "name": null,
 "type": "UEFA Champions League SRL",
 "country_id": null,
 "country_name": null,
 "country_flag": null
 },
 "scores": {
 "home_score": null,
 "away_score": null,
 "ht_score": null,
 "ft_score": null,
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0"
 },
 "weather_report": false
 },
 {
 "id": "15163896",
 "status": 0,
 "status_name": "Notstarted",
 "status_period": null,
 "pitch": null,
 "referee_id": "371",
 "round_id": "30152",
 "season_id": "1186309",
 "season_name": "2020",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": "3340",
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2020-05-20 18:00:00",
 "date": "2020-05-20",
 "time": "18:00:00",
 "minute": 90,
 "timestamp": 1589990400,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "2996",
 "name": "FC Brest",
 "short_code": "BRE",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/2996.png",
 "form": "",
 "coach_id": "1925",
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "62",
 "name": "FC BATE Borisov",
 "short_code": "BAT",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/62.png",
 "form": "",
 "coach_id": "1918",
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": "1080",
 "name": "Vysshaya Liga",
 "type": "Vysshaya League",
 "country_id": "20",
 "country_name": "Belarus",
 "country_flag": "https://cdn.soccersapi.com/images/countries/30/by.png"
 },
 "scores": {
 "home_score": null,
 "away_score": null,
 "ht_score": null,
 "ft_score": null,
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "1",
 "has_tvs": "1"
 },
 "weather_report": false
 },
 {
 "id": "20315158",
 "status": 0,
 "status_name": "Notstarted",
 "status_period": null,
 "pitch": null,
 "referee_id": null,
 "round_id": "11442",
 "season_id": "11157",
 "season_name": "19/20",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": "1104",
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2020-05-20 23:00:00",
 "date": "2020-05-20",
 "time": "23:00:00",
 "minute": 90,
 "timestamp": 1590008400,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "9191",
 "name": "AD Municipal Grecia",
 "short_code": "GRE",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/9191.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "9195",
 "name": "Perez Zeledon",
 "short_code": "ZEL",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/9195.png",
 "form": null,
 "coach_id": "1868",
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": "1518",
 "name": "Primera Division - Clausura",
 "type": "",
 "country_id": "33",
 "country_name": "Costa Rica",
 "country_flag": "https://cdn.soccersapi.com/images/countries/30/cr.png"
 },
 "scores": {
 "home_score": null,
 "away_score": null,
 "ht_score": null,
 "ft_score": null,
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0"
 },
 "weather_report": false
 },
 {
 "id": "20315161",
 "status": 0,
 "status_name": "Notstarted",
 "status_period": null,
 "pitch": null,
 "referee_id": null,
 "round_id": "11442",
 "season_id": "11157",
 "season_name": "19/20",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": "1105",
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2020-05-20 23:00:00",
 "date": "2020-05-20",
 "time": "23:00:00",
 "minute": 90,
 "timestamp": 1590008400,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "9188",
 "name": "Universidad de Costa Rica",
 "short_code": "COR",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/9188.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "9190",
 "name": "Santos de Guapiles",
 "short_code": "SDG",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/9190.png",
 "form": null,
 "coach_id": "1868",
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": "1518",
 "name": "Primera Division - Clausura",
 "type": "",
 "country_id": "33",
 "country_name": "Costa Rica",
 "country_flag": "https://cdn.soccersapi.com/images/countries/30/cr.png"
 },
 "scores": {
 "home_score": null,
 "away_score": null,
 "ht_score": null,
 "ft_score": null,
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0"
 },
 "weather_report": false
 },
 {
 "id": "15163330",
 "status": 0,
 "status_name": "Notstarted",
 "status_period": null,
 "pitch": null,
 "referee_id": "1770",
 "round_id": "2969",
 "season_id": "1366",
 "season_name": "2020",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": "3034",
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2020-05-20 18:00:00",
 "date": "2020-05-20",
 "time": "18:00:00",
 "minute": 90,
 "timestamp": 1589990400,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "3048",
 "name": "JK Tallinna Kalev",
 "short_code": "KAL",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/3048.png",
 "form": null,
 "coach_id": "5666",
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "3045",
 "name": "JK Narva Trans",
 "short_code": "NAR",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/3045.png",
 "form": null,
 "coach_id": "1738",
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": "1732",
 "name": "Meistriliiga",
 "type": "",
 "country_id": "43",
 "country_name": "Estonia",
 "country_flag": "https://cdn.soccersapi.com/images/countries/30/ee.png"
 },
 "scores": {
 "home_score": null,
 "away_score": null,
 "ht_score": null,
 "ft_score": null,
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0"
 },
 "weather_report": false
 },
 {
 "id": "15163326",
 "status": 0,
 "status_name": "Notstarted",
 "status_period": null,
 "pitch": null,
 "referee_id": "1552",
 "round_id": "2969",
 "season_id": "1366",
 "season_name": "2020",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": "2435",
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2020-05-20 18:30:00",
 "date": "2020-05-20",
 "time": "18:30:00",
 "minute": 90,
 "timestamp": 1589992200,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "3043",
 "name": "FC Flora Tallinn",
 "short_code": "FLO",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/3043.png",
 "form": null,
 "coach_id": "1703",
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "3050",
 "name": "Tartu JK Tammeka",
 "short_code": "TAR",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/3050.png",
 "form": null,
 "coach_id": "1848",
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": "1732",
 "name": "Meistriliiga",
 "type": "",
 "country_id": "43",
 "country_name": "Estonia",
 "country_flag": "https://cdn.soccersapi.com/images/countries/30/ee.png"
 },
 "scores": {
 "home_score": null,
 "away_score": null,
 "ht_score": null,
 "ft_score": null,
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0"
 },
 "weather_report": false
 },
 {
 "id": "21632105",
 "status": 0,
 "status_name": "Notstarted",
 "status_period": null,
 "pitch": null,
 "referee_id": null,
 "round_id": "29445",
 "season_id": "8579",
 "season_name": "2020",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": "4838",
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2020-05-20 16:30:00",
 "date": "2020-05-20",
 "time": "16:30:00",
 "minute": "22",
 "timestamp": 1589985000,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "2006",
 "name": "NK Istra 1961",
 "short_code": "IST",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/2006.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "2025",
 "name": "HNK Gorica",
 "short_code": "GOR",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/2025.png",
 "form": null,
 "coach_id": "2350",
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": "520",
 "name": "Club Friendly",
 "type": "",
 "country_id": "2",
 "country_name": "International Clubs",
 "country_flag": "https://cdn.soccersapi.com/images/countries/30/.png"
 },
 "scores": {
 "home_score": null,
 "away_score": null,
 "ht_score": null,
 "ft_score": null,
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0"
 },
 "weather_report": false
 },
 {
 "id": "21604047",
 "status": 0,
 "status_name": "Notstarted",
 "status_period": null,
 "pitch": null,
 "referee_id": null,
 "round_id": "29445",
 "season_id": "8579",
 "season_name": "2020",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": "3013",
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2020-05-20 17:00:00",
 "date": "2020-05-20",
 "time": "17:00:00",
 "minute": "22",
 "timestamp": 1589986800,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "1326",
 "name": "FC Hradec Kralove",
 "short_code": "HRK",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/1326.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "1593",
 "name": "FK Nachod",
 "short_code": "FK ",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/1593.png",
 "form": null,
 "coach_id": "2350",
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": "520",
 "name": "Club Friendly",
 "type": "",
 "country_id": "2",
 "country_name": "International Clubs",
 "country_flag": "https://cdn.soccersapi.com/images/countries/30/.png"
 },
 "scores": {
 "home_score": null,
 "away_score": null,
 "ht_score": null,
 "ft_score": null,
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0"
 },
 "weather_report": false
 },
 {
 "id": "21489678",
 "status": 0,
 "status_name": "Notstarted",
 "status_period": null,
 "pitch": null,
 "referee_id": null,
 "round_id": "29445",
 "season_id": "8579",
 "season_name": "2020",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": "436",
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2020-05-20 17:30:00",
 "date": "2020-05-20",
 "time": "17:30:00",
 "minute": 90,
 "timestamp": 1589988600,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "2108",
 "name": "FK Vojvodina",
 "short_code": "VOJ",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/2108.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "2109",
 "name": "OFK Backa Palanka",
 "short_code": "BAP",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/2109.png",
 "form": null,
 "coach_id": "2350",
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": "520",
 "name": "Club Friendly",
 "type": "",
 "country_id": "2",
 "country_name": "International Clubs",
 "country_flag": "https://cdn.soccersapi.com/images/countries/30/.png"
 },
 "scores": {
 "home_score": null,
 "away_score": null,
 "ht_score": null,
 "ft_score": null,
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0"
 },
 "weather_report": false
 },
 {
 "id": "21489721",
 "status": 0,
 "status_name": "Notstarted",
 "status_period": null,
 "pitch": null,
 "referee_id": null,
 "round_id": "30331",
 "season_id": "4852790",
 "season_name": "19/20",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": null,
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2020-05-20 18:00:00",
 "date": "2020-05-20",
 "time": "18:00:00",
 "minute": 90,
 "timestamp": 1589990400,
 "timezone": "UTC"
 },
...

Test Endpoint

Livescores Ended

The Livescores Ended Endpoint gives you a list of matches will play today and has ended. (From the leagues available in your plan)

GETEnded Matches

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringended

Response

Response Example

                    {
 "data": [
 {
 "id": "21294795",
 "status": "3",
 "status_name": "Finished",
 "status_period": null,
 "pitch": null,
 "referee_id": null,
 "round_id": "30333",
 "season_id": "17170743",
 "season_name": "2020",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": null,
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2020-05-20 00:15:00",
 "date": "2020-05-20",
 "time": "00:15:00",
 "minute": 90,
 "timestamp": 1589926500,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "18966",
 "name": "Colo Colo SRL",
 "short_code": "COC",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/18966.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "18967",
 "name": "Penarol Montevideo SRL",
 "short_code": "PEN",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/18967.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": null,
 "name": null,
 "type": "Copa Libertadores SRL",
 "country_id": null,
 "country_name": null,
 "country_flag": null
 },
 "scores": {
 "home_score": "2",
 "away_score": "0",
 "ht_score": "1-0",
 "ft_score": "2-0",
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0"
 },
 "weather_report": false
 },
 {
 "id": "21294798",
 "status": "3",
 "status_name": "Finished",
 "status_period": null,
 "pitch": null,
 "referee_id": null,
 "round_id": "30333",
 "season_id": "17170743",
 "season_name": "2020",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": null,
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2020-05-20 00:15:00",
 "date": "2020-05-20",
 "time": "00:15:00",
 "minute": 90,
 "timestamp": 1589926500,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "18968",
 "name": "Defensa Justicia SRL",
 "short_code": "DEF",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/18968.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "18969",
 "name": "Delfin SC SRL",
 "short_code": "DEL",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/18969.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": null,
 "name": null,
 "type": "Copa Libertadores SRL",
 "country_id": null,
 "country_name": null,
 "country_flag": null
 },
 "scores": {
 "home_score": "3",
 "away_score": "0",
 "ht_score": "1-0",
 "ft_score": "3-0",
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0"
 },
 "weather_report": false
 },
 {
 "id": "21294802",
 "status": "3",
 "status_name": "Finished",
 "status_period": null,
 "pitch": null,
 "referee_id": null,
 "round_id": "30333",
 "season_id": "17170743",
 "season_name": "2020",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": null,
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2020-05-20 00:15:00",
 "date": "2020-05-20",
 "time": "00:15:00",
 "minute": 90,
 "timestamp": 1589926500,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "18970",
 "name": "Jorge Wilstermann SRL",
 "short_code": "WIL",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/18970.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "18971",
 "name": "CA Paranaense PR SRL",
 "short_code": "PAR",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/18971.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": null,
 "name": null,
 "type": "Copa Libertadores SRL",
 "country_id": null,
 "country_name": null,
 "country_flag": null
 },
 "scores": {
 "home_score": "0",
 "away_score": "1",
 "ht_score": "0-0",
 "ft_score": "0-1",
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0"
 },
 "weather_report": false
 },
 {
 "id": "21317072",
 "status": "3",
 "status_name": "Finished",
 "status_period": null,
 "pitch": null,
 "referee_id": null,
 "round_id": "30333",
 "season_id": "17170743",
 "season_name": "2020",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": null,
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2020-05-20 02:30:00",
 "date": "2020-05-20",
 "time": "02:30:00",
 "minute": 90,
 "timestamp": 1589934600,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "18972",
 "name": "EM Deportivo Binacional SRL",
 "short_code": "BIN",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/18972.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "18973",
 "name": "LDU Quito SRL",
 "short_code": "LDU",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/18973.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": null,
 "name": null,
 "type": "Copa Libertadores SRL",
 "country_id": null,
 "country_name": null,
 "country_flag": null
 },
 "scores": {
 "home_score": "0",
 "away_score": "3",
 "ht_score": "0-2",
 "ft_score": "0-3",
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0"
 },
 "weather_report": false
 },
 {
 "id": "21317075",
 "status": "3",
 "status_name": "Finished",
 "status_period": null,
 "pitch": null,
 "referee_id": null,
 "round_id": "30333",
 "season_id": "17170743",
 "season_name": "2020",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": null,
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2020-05-20 02:30:00",
 "date": "2020-05-20",
 "time": "02:30:00",
 "minute": 90,
 "timestamp": 1589934600,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "18974",
 "name": "Santos SRL",
 "short_code": "SAN",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/18974.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "18975",
 "name": "Olimpia SRL",
 "short_code": "OLI",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/18975.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": null,
 "name": null,
 "type": "Copa Libertadores SRL",
 "country_id": null,
 "country_name": null,
 "country_flag": null
 },
 "scores": {
 "home_score": "1",
 "away_score": "2",
 "ht_score": "1-0",
 "ft_score": "1-2",
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0"
 },
 "weather_report": false
 },
 {
 "id": "21317078",
 "status": "3",
 "status_name": "Finished",
 "status_period": null,
 "pitch": null,
 "referee_id": null,
 "round_id": "30333",
 "season_id": "17170743",
 "season_name": "2020",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": null,
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2020-05-20 02:30:00",
 "date": "2020-05-20",
 "time": "02:30:00",
 "minute": 90,
 "timestamp": 1589934600,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "18976",
 "name": "Sao Paulo FC SP SRL",
 "short_code": "SAP",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/18976.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "18977",
 "name": "CA River Plate SRL",
 "short_code": "RIV",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/18977.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": null,
 "name": null,
 "type": "Copa Libertadores SRL",
 "country_id": null,
 "country_name": null,
 "country_flag": null
 },
 "scores": {
 "home_score": "1",
 "away_score": "2",
 "ht_score": "1-0",
 "ft_score": "1-2",
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0"
 },
 "weather_report": false
 },
 {
 "id": "20315155",
 "status": "3",
 "status_name": "Finished",
 "status_period": null,
 "pitch": null,
 "referee_id": null,
 "round_id": "11442",
 "season_id": "11157",
 "season_name": "19/20",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": "1103",
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2020-05-20 04:00:00",
 "date": "2020-05-20",
 "time": "04:00:00",
 "minute": 90,
 "timestamp": 1589940000,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "9189",
 "name": "CS Cartagines",
 "short_code": "CAR",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/9189.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "9194",
 "name": "Liga Deportiva Alajuelense",
 "short_code": "ALA",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/9194.png",
 "form": null,
 "coach_id": "1868",
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": "1518",
 "name": "Primera Division - Clausura",
 "type": "",
 "country_id": "33",
 "country_name": "Costa Rica",
 "country_flag": "https://cdn.soccersapi.com/images/countries/30/cr.png"
 },
 "scores": {
 "home_score": "0",
 "away_score": "2",
 "ht_score": "0-1",
 "ft_score": "0-2",
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0"
 },
 "weather_report": false
 },
 {
 "id": "21489675",
 "status": "3",
 "status_name": "Finished",
 "status_period": null,
 "pitch": null,
 "referee_id": null,
 "round_id": "29445",
 "season_id": "8579",
 "season_name": "2020",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": "2895",
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2020-05-20 11:00:00",
 "date": "2020-05-20",
 "time": "11:00:00",
 "minute": 90,
 "timestamp": 1589965200,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "1324",
 "name": "Zbrojovka Brno",
 "short_code": "BRN",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/1324.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "1646",
 "name": "FC Fastav Zlin",
 "short_code": "FCZ",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/1646.png",
 "form": null,
 "coach_id": "2350",
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": "520",
 "name": "Club Friendly",
 "type": "",
 "country_id": "2",
 "country_name": "International Clubs",
 "country_flag": "https://cdn.soccersapi.com/images/countries/30/.png"
 },
 "scores": {
 "home_score": "0",
 "away_score": "5",
 "ht_score": "0-1",
 "ft_score": "0-5",
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0"
 },
 "weather_report": false
 }
 ],
...

Test Endpoint

Fixtures by Date

The Fixtures by Date Endpoint gives you fixtures from a specific date.

GETFixtures By date

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringschedule
ddate{{YYYY-MM-DD}}
pageinteger{{PAGE}}

Response

Response Example

                    {
 "data": [
 {
 "id": "15006764",
 "status": "5",
 "status_name": "Canceled",
 "status_period": null,
 "pitch": null,
 "referee_id": null,
 "round_id": null,
 "season_id": "60501",
 "season_name": "2020",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": "3293",
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2020-05-16 10:30:00",
 "date": "2020-05-16",
 "time": "10:30:00",
 "minute": 90,
 "timestamp": 1589617800,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "18410",
 "name": "Asia Euro United FC",
 "short_code": "AEU",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/18410.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "14637",
 "name": "Nagaworld FC",
 "short_code": "NAG",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/14637.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": "4126",
 "name": "Cambodian Premier League",
 "type": "",
 "country_id": null,
 "country_name": null,
 "country_flag": null
 },
 "scores": {
 "home_score": null,
 "away_score": null,
 "ht_score": null,
 "ft_score": null,
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0"
 },
 "weather_report": false
 },
 {
 "id": "15006766",
 "status": "5",
 "status_name": "Canceled",
 "status_period": null,
 "pitch": null,
 "referee_id": null,
 "round_id": null,
 "season_id": "60501",
 "season_name": "2020",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": "2892",
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2020-05-16 10:30:00",
 "date": "2020-05-16",
 "time": "10:30:00",
 "minute": 90,
 "timestamp": 1589617800,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "18447",
 "name": "Kirivong Soksen Chey",
 "short_code": "KSC",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/18447.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "18409",
 "name": "National Defense Ministry FC",
 "short_code": "NDM",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/18409.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": "4126",
 "name": "Cambodian Premier League",
 "type": "",
 "country_id": null,
 "country_name": null,
 "country_flag": null
 },
 "scores": {
 "home_score": null,
 "away_score": null,
 "ht_score": null,
 "ft_score": null,
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0"
 },
 "weather_report": false
 },
 {
 "id": "15006769",
 "status": "5",
 "status_name": "Canceled",
 "status_period": null,
 "pitch": null,
 "referee_id": null,
 "round_id": null,
 "season_id": "60501",
 "season_name": "2020",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": "2892",
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2020-05-16 13:00:00",
 "date": "2020-05-16",
 "time": "13:00:00",
 "minute": 90,
 "timestamp": 1589626800,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "14643",
 "name": "Phnom Penh",
 "short_code": "PHN",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/14643.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "18411",
 "name": "Soltilo Angkor FC",
 "short_code": "SOA",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/18411.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": "4126",
 "name": "Cambodian Premier League",
 "type": "",
 "country_id": null,
 "country_name": null,
 "country_flag": null
 },
 "scores": {
 "home_score": null,
 "away_score": null,
 "ht_score": null,
 "ft_score": null,
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0"
 },
 "weather_report": false
 },
 {
 "id": "59455",
 "status": "4",
 "status_name": "Postponed",
 "status_period": null,
 "pitch": null,
 "referee_id": null,
 "round_id": null,
 "season_id": "7991",
 "season_name": "19/20",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": "628",
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2020-05-16 15:00:00",
 "date": "2020-05-16",
 "time": "15:00:00",
 "minute": 90,
 "timestamp": 1589634000,
 "timezone": "UTC"
 },
...

Test Endpoint

Fixtures by Date / Country

The Fixtures by Date / Country Endpoint fixtures from a single country on a specific date

GETFixtures By Date and Country ID

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringschedule
ddate{{YYYY-MM-DD}}
country_idinteger{{COUNTRY_ID}}

Response

Response Example

                    {
 "data": [
 {
 "id": "15006925",
 "status": "3",
 "status_name": "Finished",
 "status_period": null,
 "pitch": null,
 "referee_id": "224",
 "round_id": null,
 "season_id": "613",
 "season_name": "19/20",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": "791",
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2020-05-16 13:00:00",
 "date": "2020-05-16",
 "time": "13:00:00",
 "minute": 90,
 "timestamp": 1589626800,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "2862",
 "name": "Erzgebirge Aue",
 "short_code": "AUE",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/2862.png",
 "form": "3-4-1-2",
 "coach_id": "694",
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "2854",
 "name": "SV Sandhausen",
 "short_code": "SVS",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/2854.png",
 "form": "4-5-1",
 "coach_id": "693",
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": "592",
 "name": "2. Bundesliga",
 "type": "",
 "country_id": "4",
 "country_name": "Germany",
 "country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
 },
 "scores": {
 "home_score": "3",
 "away_score": "1",
 "ht_score": "1-0",
 "ft_score": "3-1",
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "1",
 "has_tvs": "1"
 },
 "weather_report": false
 },
 {
 "id": "15006928",
 "status": "3",
 "status_name": "Finished",
 "status_period": null,
 "pitch": null,
 "referee_id": "81",
 "round_id": null,
 "season_id": "613",
 "season_name": "19/20",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": "789",
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2020-05-16 13:00:00",
 "date": "2020-05-16",
 "time": "13:00:00",
 "minute": 90,
 "timestamp": 1589626800,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "2864",
 "name": "Karlsruher SC",
 "short_code": "KSC",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/2864.png",
 "form": "4-2-3-1",
 "coach_id": "690",
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "2858",
 "name": "SV Darmstadt 1898",
 "short_code": "DAR",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/2858.png",
 "form": "4-5-1",
 "coach_id": "692",
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": "592",
 "name": "2. Bundesliga",
 "type": "",
 "country_id": "4",
 "country_name": "Germany",
 "country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
 },
 "scores": {
 "home_score": "2",
 "away_score": "0",
 "ht_score": "0-0",
 "ft_score": "2-0",
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "1",
 "has_tvs": "1"
 },
 "weather_report": false
 },
 {
 "id": "15006930",
 "status": "3",
 "status_name": "Finished",
 "status_period": null,
 "pitch": null,
 "referee_id": "580",
 "round_id": null,
 "season_id": "613",
 "season_name": "19/20",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": "286",
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2020-05-16 13:00:00",
 "date": "2020-05-16",
 "time": "13:00:00",
 "minute": 90,
 "timestamp": 1589626800,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "2859",
 "name": "SSV Jahn Regensburg",
 "short_code": "JRE",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/2859.png",
 "form": "",
 "coach_id": "260",
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "2853",
 "name": "Holstein Kiel",
 "short_code": "HOK",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/2853.png",
 "form": "",
 "coach_id": "695",
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": "592",
 "name": "2. Bundesliga",
 "type": "",
 "country_id": "4",
 "country_name": "Germany",
 "country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
 },
 "scores": {
 "home_score": "2",
 "away_score": "2",
 "ht_score": "0-1",
 "ft_score": "2-2",
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "1",
 "has_tvs": "1"
 },
 "weather_report": false
 },
 {
 "id": "15006932",
 "status": "3",
 "status_name": "Finished",
 "status_period": null,
 "pitch": null,
 "referee_id": "453",
 "round_id": null,
 "season_id": "613",
 "season_name": "19/20",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": "1171",
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2020-05-16 13:00:00",
 "date": "2020-05-16",
 "time": "13:00:00",
 "minute": 90,
 "timestamp": 1589626800,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "2860",
 "name": "VfL Bochum",
 "short_code": "BOC",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/2860.png",
 "form": "4-2-3-1",
 "coach_id": "974",
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "2856",
 "name": "1. FC Heidenheim 1846",
 "short_code": "HEI",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/2856.png",
 "form": "4-3-1-2",
 "coach_id": "1239",
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": "592",
 "name": "2. Bundesliga",
 "type": "",
 "country_id": "4",
 "country_name": "Germany",
 "country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
 },
 "scores": {
 "home_score": "3",
 "away_score": "0",
 "ht_score": "2-0",
 "ft_score": "3-0",
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "1",
 "has_tvs": "1"
 },
 "weather_report": false
 },
 {
 "id": "48522",
 "status": "4",
 "status_name": "Postponed",
 "status_period": null,
 "pitch": null,
 "referee_id": null,
 "round_id": null,
 "season_id": "3223",
 "season_name": "19/20",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": "1732",
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2020-05-16 13:30:00",
 "date": "2020-05-16",
 "time": "13:30:00",
 "minute": 90,
 "timestamp": 1589628600,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "3162",
 "name": "FC Wurzburger Kickers",
 "short_code": "FWK",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/3162.png",
 "form": "",
 "coach_id": "1276",
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "3173",
 "name": "Hallescher FC",
 "short_code": "HFC",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/3173.png",
 "form": "",
 "coach_id": "282",
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": "593",
 "name": "3. Liga",
 "type": "",
 "country_id": "4",
 "country_name": "Germany",
 "country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
 },
 "scores": {
 "home_score": null,
 "away_score": null,
 "ht_score": null,
 "ft_score": null,
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "1",
 "has_tvs": "1"
 },
 "weather_report": false
 },
 {
 "id": "48523",
 "status": "4",
 "status_name": "Postponed",
 "status_period": null,
 "pitch": null,
 "referee_id": null,
 "round_id": null,
 "season_id": "3223",
 "season_name": "19/20",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": "1733",
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2020-05-16 13:30:00",
 "date": "2020-05-16",
 "time": "13:30:00",
 "minute": 90,
 "timestamp": 1589628600,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "3155",
 "name": "1 FC Kaiserslautern",
 "short_code": "FCK",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/3155.png",
 "form": "",
 "coach_id": "265",
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "3846",
 "name": "FC Bayern Munich II",
 "short_code": "FCB",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/3846.png",
 "form": "",
 "coach_id": "985",
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": "593",
 "name": "3. Liga",
 "type": "",
 "country_id": "4",
 "country_name": "Germany",
 "country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
 },
 "scores": {
 "home_score": null,
 "away_score": null,
 "ht_score": null,
 "ft_score": null,
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "1",
 "has_tvs": "1"
 },
 "weather_report": false
 },
 {
 "id": "48524",
 "status": "4",
 "status_name": "Postponed",
 "status_period": null,
 "pitch": null,
 "referee_id": null,
 "round_id": null,
 "season_id": "3223",
 "season_name": "19/20",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": "1731",
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2020-05-16 13:30:00",
 "date": "2020-05-16",
 "time": "13:30:00",
 "minute": 90,
 "timestamp": 1589628600,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "3172",
 "name": "MSV Duisburg",
 "short_code": "MSV",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/3172.png",
 "form": "",
 "coach_id": "785",
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "3841",
 "name": "SpVgg Unterhaching",
 "short_code": "UHA",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/3841.png",
 "form": "",
 "coach_id": "270",
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": "593",
 "name": "3. Liga",
 "type": "",
 "country_id": "4",
 "country_name": "Germany",
 "country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
 },
 "scores": {
 "home_score": null,
 "away_score": null,
 "ht_score": null,
 "ft_score": null,
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "1",
 "has_tvs": "1"
 },
 "weather_report": false
 },
...

Test Endpoint

Fixtures by Date / League (Current Season)

The Fixtures by Date / League Endpoint return fixtures of the current season from a single league and specific date

GETFixtures by Date and League ID

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringschedule
ddate{{YYYY-MM-DD}}
league_idinteger{{LEAGUE_ID}}

Response

Response Example

                    {
 "data": [
 {
 "id": "31459",
 "status": "4",
 "status_name": "Postponed",
 "status_period": null,
 "pitch": null,
 "referee_id": null,
 "round_id": null,
 "season_id": "406",
 "season_name": "19/20",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": "1216",
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2020-05-16 15:30:00",
 "date": "2020-05-16",
 "time": "15:30:00",
 "minute": 90,
 "timestamp": 1589635800,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "98",
 "name": "Borussia Dortmund",
 "short_code": "BVB",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/98.png",
 "form": "3-4-3",
 "coach_id": "1007",
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "2818",
 "name": "TSG 1899 Hoffenheim",
 "short_code": "TSG",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/2818.png",
 "form": "3-4-3",
 "coach_id": "61",
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": "594",
 "name": "Bundesliga",
 "type": "",
 "country_id": "4",
 "country_name": "Germany",
 "country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
 },
 "scores": {
 "home_score": null,
 "away_score": null,
 "ht_score": null,
 "ft_score": null,
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "1",
 "has_tvs": "1"
 },
 "weather_report": false
 },
 {
 "id": "31460",
 "status": "4",
 "status_name": "Postponed",
 "status_period": null,
 "pitch": null,
 "referee_id": null,
 "round_id": null,
 "season_id": "406",
 "season_name": "19/20",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": "1386",
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2020-05-16 15:30:00",
 "date": "2020-05-16",
 "time": "15:30:00",
 "minute": 90,
 "timestamp": 1589635800,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "114",
 "name": "Bayer 04 Leverkusen",
 "short_code": "B04",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/114.png",
 "form": "4-2-3-1",
 "coach_id": "54",
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "2813",
 "name": "1. FSV Mainz 05",
 "short_code": "M05",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/2813.png",
 "form": "3-4-3",
 "coach_id": "663",
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": "594",
 "name": "Bundesliga",
 "type": "",
 "country_id": "4",
 "country_name": "Germany",
 "country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
 },
 "scores": {
 "home_score": null,
 "away_score": null,
 "ht_score": null,
 "ft_score": null,
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "1",
 "has_tvs": "1"
 },
 "weather_report": false
 },
 {
 "id": "31461",
 "status": "4",
 "status_name": "Postponed",
 "status_period": null,
 "pitch": null,
 "referee_id": null,
 "round_id": null,
 "season_id": "406",
 "season_name": "19/20",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": "1622",
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2020-05-16 15:30:00",
 "date": "2020-05-16",
 "time": "15:30:00",
 "minute": 90,
 "timestamp": 1589635800,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "2815",
 "name": "Borussia Monchengladbach",
 "short_code": "BMG",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/2815.png",
 "form": "4-2-3-1",
 "coach_id": "64",
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "2806",
 "name": "Hertha BSC",
 "short_code": "BSC",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/2806.png",
 "form": "4-2-3-1",
 "coach_id": "2681",
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": "594",
 "name": "Bundesliga",
 "type": "",
 "country_id": "4",
 "country_name": "Germany",
 "country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
 },
 "scores": {
 "home_score": null,
 "away_score": null,
 "ht_score": null,
 "ft_score": null,
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "1",
 "has_tvs": "1"
 },
 "weather_report": false
 },
...

Test Endpoint

Fixtures by Date / Season

The Fixtures by Date / Season Endpoint gives you fixtures from a single season on a specific date

GETFixtures By Date and Season ID

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringseason
ddate{{YYYY-MM-DD}}
idinteger{{SEASON_ID}}

Response

Response Example

                    {
 "data": [
 {
 "id": "31459",
 "status": "4",
 "status_name": "Postponed",
 "status_period": null,
 "pitch": null,
 "referee_id": null,
 "round_id": null,
 "season_id": "406",
 "season_name": "19/20",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": "1216",
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2020-05-16 15:30:00",
 "date": "2020-05-16",
 "time": "15:30:00",
 "minute": 90,
 "timestamp": 1589635800,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "98",
 "name": "Borussia Dortmund",
 "short_code": "BVB",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/98.png",
 "form": "3-4-3",
 "coach_id": "1007",
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "2818",
 "name": "TSG 1899 Hoffenheim",
 "short_code": "TSG",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/2818.png",
 "form": "3-4-3",
 "coach_id": "61",
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": "594",
 "name": "Bundesliga",
 "type": "",
 "country_id": "4",
 "country_name": "Germany",
 "country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
 },
 "scores": {
 "home_score": null,
 "away_score": null,
 "ht_score": null,
 "ft_score": null,
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "1",
 "has_tvs": "1"
 },
 "weather_report": false
 },
 {
 "id": "31460",
 "status": "4",
 "status_name": "Postponed",
 "status_period": null,
 "pitch": null,
 "referee_id": null,
 "round_id": null,
 "season_id": "406",
 "season_name": "19/20",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": "1386",
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2020-05-16 15:30:00",
 "date": "2020-05-16",
 "time": "15:30:00",
 "minute": 90,
 "timestamp": 1589635800,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "114",
 "name": "Bayer 04 Leverkusen",
 "short_code": "B04",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/114.png",
 "form": "4-2-3-1",
 "coach_id": "54",
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "2813",
 "name": "1. FSV Mainz 05",
 "short_code": "M05",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/2813.png",
 "form": "3-4-3",
 "coach_id": "663",
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": "594",
 "name": "Bundesliga",
 "type": "",
 "country_id": "4",
 "country_name": "Germany",
 "country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
 },
 "scores": {
 "home_score": null,
 "away_score": null,
 "ht_score": null,
 "ft_score": null,
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "1",
 "has_tvs": "1"
 },
 "weather_report": false
 },
 {
 "id": "31461",
 "status": "4",
 "status_name": "Postponed",
 "status_period": null,
 "pitch": null,
 "referee_id": null,
 "round_id": null,
 "season_id": "406",
 "season_name": "19/20",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": "1622",
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2020-05-16 15:30:00",
 "date": "2020-05-16",
 "time": "15:30:00",
 "minute": 90,
 "timestamp": 1589635800,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "2815",
 "name": "Borussia Monchengladbach",
 "short_code": "BMG",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/2815.png",
 "form": "4-2-3-1",
 "coach_id": "64",
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "2806",
 "name": "Hertha BSC",
 "short_code": "BSC",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/2806.png",
 "form": "4-2-3-1",
 "coach_id": "2681",
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": "594",
 "name": "Bundesliga",
 "type": "",
 "country_id": "4",
 "country_name": "Germany",
 "country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
 },
 "scores": {
 "home_score": null,
 "away_score": null,
 "ht_score": null,
 "ft_score": null,
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "1",
 "has_tvs": "1"
 },
 "weather_report": false
 },
...

Test Endpoint

Fixtures by Date / Season / Stage

The Fixtures by Date / Season / Stage Endpoint gives you fixtures from a single season stage on a specific date

GETFixtures by Date, Season ID and Stage ID

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringstages
ddate{{YYYY-MM-DD}}
season_idinteger{{SEASON_ID}}
stage_idinteger{{STAGE_ID}}
orderstring{{ORDER}}

Response

Response Example

                    {
 "data": [
 {
 "id": 1315510,
 "status": "3",
 "status_name": "Finished",
 "status_period": null,
 "pitch": null,
 "referee_id": null,
 "round_id": "130387",
 "round_name": "1",
 "season_id": "7355",
 "season_name": "20/21",
 "stage_id": "6",
 "stage_name": "Group stage",
 "group_id": "9",
 "group_name": "4",
 "aggregate_id": null,
 "winner_team_id": "849",
 "venue_id": "3975",
 "leg": null,
 "week": "38",
 "deleted": "0",
 "time": {
 "datetime": "2020-09-16 12:00:00",
 "date": "2020-09-16",
 "time": "12:00:00",
 "minute": 90,
 "timestamp": 1600250400,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "829",
 "name": "Leningradets",
 "short_code": "LEN",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/829.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "849",
 "name": "FC Ufa",
 "short_code": "UFA",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/849.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": "3219",
 "name": "Russian Cup",
 "type": "Russian Cup, Group 4",
 "country_id": "100",
 "country_name": "Russia",
 "country_flag": "https://cdn.soccersapi.com/images/countries/30/ru.png"
 },
 "scores": {
 "home_score": "0",
 "away_score": "1",
 "ht_score": "0-0",
 "ft_score": "0-1",
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0",
 "has_standings": "1"
 },
 "weather_report": false
 },
...

Test Endpoint

Fixtures by Season / Stage

The Fixtures by Season / Stage Endpoint gives you fixtures from a single season stage

GETFixtures By Season ID and Stage ID

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringstage
season_idinteger{{SEASON_ID}}
stage_idinteger{{STAGE_ID}}
orderstring{{ORDER}}

Response

Response Example

                     {
 "data": [
 {
 "id": 33189,
 "status": "3",
 "status_name": "Finished",
 "status_period": null,
 "pitch": null,
 "referee_id": "1277",
 "round_id": "2241",
 "season_id": "640",
 "season_name": "19/20",
 "stage_id": "1",
 "stage_name": "Regular Season",
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": "104",
 "venue_id": "2424",
 "leg": null,
 "deleted": "0",
 "time": {
 "datetime": "2019-09-14 17:00:00",
 "date": "2019-09-14",
 "time": "17:00:00",
 "minute": 90,
 "timestamp": 1568473200,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "104",
 "name": "FC Salzburg",
 "short_code": "SAL",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/104.png",
 "form": "4-4-2",
 "coach_id": "1094",
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "2873",
 "name": "TSV Hartberg",
 "short_code": "HTB",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/2873.png",
 "form": "4-3-3",
 "coach_id": "182",
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": "1005",
 "name": "Tipico Bundesliga",
 "type": "",
 "country_id": "15",
 "country_name": "Austria",
 "country_flag": "https://cdn.soccersapi.com/images/countries/30/at.png"
 },
 "scores": {
 "home_score": "7",
 "away_score": "2",
 "ht_score": "2-1",
 "ft_score": "7-2",
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "1",
 "has_tvs": "1",
 "has_standings": "1"
 },
 "weather_report": false
 },
...

Test Endpoint

Fixtures by Date / Season / Group

The Fixtures by Date / Season / Group Endpoint gives you fixtures from a single Group on a specific date

GETFixtures by Date, Season ID and Group ID

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringschedule
ddate{{YYYY-MM-DD}}
season_idinteger{{SEASON_ID}}
group_idinteger{{GROUP_ID}}

Response

Response Example

                    {
 "data": [
 {
 "id": 1286443,
 "status": "3",
 "status_name": "Finished",
 "status_period": null,
 "pitch": null,
 "referee_id": null,
 "round_id": "128037",
 "round_name": "5",
 "season_id": "7169",
 "season_name": "2021",
 "stage_id": "1",
 "stage_name": "Regular Season",
 "group_id": "1",
 "group_name": "Apertura",
 "aggregate_id": null,
 "winner_team_id": "19364",
 "venue_id": "5695",
 "leg": null,
 "week": "38",
 "deleted": "0",
 "time": {
 "datetime": "2020-09-16 02:05:00",
 "date": "2020-09-16",
 "time": "02:05:00",
 "minute": 90,
 "timestamp": 1600214700,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "19364",
 "name": "Tepatitlan FC",
 "short_code": "TEP",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/19364.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "6946",
 "name": "Venados FC",
 "short_code": "VDS",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/6946.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": "4178",
 "name": "Liga de Expansion MX, Apertura",
 "type": "",
 "country_id": "76",
 "country_name": "Mexico",
 "country_flag": "https://cdn.soccersapi.com/images/countries/30/mx.png"
 },
 "scores": {
 "home_score": "2",
 "away_score": "0",
 "ht_score": "0-0",
 "ft_score": "2-0",
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0",
 "has_standings": "1"
 },
 "weather_report": false
 },
...

Test Endpoint

Fixtures by Date / Round

The Fixtures by Date / Round Endpoint gives you fixtures from a single round on a specific date

GETFixtures by Date and Round ID

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringrounds
ddateYYYY-MM-DD
idinteger{{ROUND_ID}}

Response

Response Example

                    {
 "data": [
 {
 "id": "32851",
 "status": "3",
 "status_name": "Finished",
 "status_period": null,
 "pitch": null,
 "referee_id": "272",
 "round_id": "2202",
 "season_id": "613",
 "season_name": "19/20",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": "1636",
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2019-07-28 11:30:00",
 "date": "2019-07-28",
 "time": "11:30:00",
 "minute": 90,
 "timestamp": 1564306200,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "2857",
 "name": "Hamburger SV",
 "short_code": "HSV",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/2857.png",
 "form": null,
 "coach_id": "259",
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "2858",
 "name": "SV Darmstadt 1898",
 "short_code": "DAR",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/2858.png",
 "form": null,
 "coach_id": "692",
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": "592",
 "name": "2. Bundesliga",
 "type": "",
 "country_id": "4",
 "country_name": "Germany",
 "country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
 },
 "scores": {
 "home_score": "1",
 "away_score": "1",
 "ht_score": "0-0",
 "ft_score": "1-1",
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0"
 },
 "weather_report": false
 },
 {
 "id": "32852",
 "status": "3",
 "status_name": "Finished",
 "status_period": null,
 "pitch": null,
 "referee_id": "1249",
 "round_id": "2202",
 "season_id": "613",
 "season_name": "19/20",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": "286",
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2019-07-28 13:30:00",
 "date": "2019-07-28",
 "time": "13:30:00",
 "minute": 90,
 "timestamp": 1564313400,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "2859",
 "name": "SSV Jahn Regensburg",
 "short_code": "JRE",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/2859.png",
 "form": null,
 "coach_id": "260",
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "2860",
 "name": "VfL Bochum",
 "short_code": "BOC",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/2860.png",
 "form": null,
 "coach_id": "4493",
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": "592",
 "name": "2. Bundesliga",
 "type": "",
 "country_id": "4",
 "country_name": "Germany",
 "country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
 },
 "scores": {
 "home_score": "3",
 "away_score": "1",
 "ht_score": "1-0",
 "ft_score": "3-1",
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0"
 },
 "weather_report": false
 },
 {
 "id": "32853",
 "status": "3",
 "status_name": "Finished",
 "status_period": null,
 "pitch": null,
 "referee_id": "27",
 "round_id": "2202",
 "season_id": "613",
 "season_name": "19/20",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": "284",
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2019-07-28 13:30:00",
 "date": "2019-07-28",
 "time": "13:30:00",
 "minute": 90,
 "timestamp": 1564313400,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "2861",
 "name": "Greuther Furth",
 "short_code": "SGF",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/2861.png",
 "form": null,
 "coach_id": "256",
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "2862",
 "name": "Erzgebirge Aue",
 "short_code": "AUE",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/2862.png",
 "form": null,
 "coach_id": "4567",
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": "592",
 "name": "2. Bundesliga",
 "type": "",
 "country_id": "4",
 "country_name": "Germany",
 "country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
 },
 "scores": {
 "home_score": "0",
 "away_score": "2",
 "ht_score": "0-1",
 "ft_score": "0-2",
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0"
 },
 "weather_report": false
 },
...

Test Endpoint

Fixtures by Season

The Fixtures Season Endpoint gives you fixtures from a specific Season by ID

GETFixtures By Season ID

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringseason
season_idinteger{{SEASON_ID}}
orderstring{{ORDER}}

Response

Response Example

                    {
 "data": [
 {
 "id": "31162",
 "status": "3",
 "status_name": "Finished",
 "status_period": null,
 "pitch": null,
 "referee_id": "22",
 "round_id": "1994",
 "season_id": "406",
 "season_name": "19/20",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": "1446",
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2019-08-16 18:30:00",
 "date": "2019-08-16",
 "time": "18:30:00",
 "minute": 90,
 "timestamp": 1565973000,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "111",
 "name": "FC Bayern Munich",
 "short_code": "FCB",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/111.png",
 "form": null,
 "coach_id": "3757",
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "2806",
 "name": "Hertha BSC",
 "short_code": "BSC",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/2806.png",
 "form": null,
 "coach_id": "3189",
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": "594",
 "name": "Bundesliga",
 "type": "",
 "country_id": "4",
 "country_name": "Germany",
 "country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
 },
 "scores": {
 "home_score": "2",
 "away_score": "2",
 "ht_score": "1-2",
 "ft_score": "2-2",
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0"
 },
 "weather_report": false
 },
 {
 "id": "31163",
 "status": "3",
 "status_name": "Finished",
 "status_period": null,
 "pitch": null,
 "referee_id": "80",
 "round_id": "1994",
 "season_id": "406",
 "season_name": "19/20",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": "1386",
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2019-08-17 13:30:00",
 "date": "2019-08-17",
 "time": "13:30:00",
 "minute": 90,
 "timestamp": 1566041400,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "114",
 "name": "Bayer 04 Leverkusen",
 "short_code": "B04",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/114.png",
 "form": null,
 "coach_id": "54",
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "2807",
 "name": "SC Paderborn 07",
 "short_code": "PAD",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/2807.png",
 "form": null,
 "coach_id": "59",
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": "594",
 "name": "Bundesliga",
 "type": "",
 "country_id": "4",
 "country_name": "Germany",
 "country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
 },
 "scores": {
 "home_score": "3",
 "away_score": "2",
 "ht_score": "2-2",
 "ft_score": "3-2",
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0"
 },
 "weather_report": false
 },
 {
 "id": "31164",
 "status": "3",
 "status_name": "Finished",
 "status_period": null,
 "pitch": null,
 "referee_id": "434",
 "round_id": "1994",
 "season_id": "406",
 "season_name": "19/20",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": "1388",
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2019-08-17 13:30:00",
 "date": "2019-08-17",
 "time": "13:30:00",
 "minute": 90,
 "timestamp": 1566041400,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "2808",
 "name": "VfL Wolfsburg",
 "short_code": "WOB",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/2808.png",
 "form": null,
 "coach_id": "62",
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "2809",
 "name": "1. FC Cologne",
 "short_code": "KOE",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/2809.png",
 "form": null,
 "coach_id": "663",
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": "594",
 "name": "Bundesliga",
 "type": "",
 "country_id": "4",
 "country_name": "Germany",
 "country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
 },
 "scores": {
 "home_score": "2",
 "away_score": "1",
 "ht_score": "1-0",
 "ft_score": "2-1",
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0"
 },
 "weather_report": false
 },
...

Test Endpoint

Fixtures by Season / Team

The Fixtures Season Endpoint gives you fixtures from a specific Season by ID and Team ID

GETFixtures By Season ID and Team ID

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringseason
season_idinteger{{SEASON_ID}}
team_idinteger{{TEAM_ID}}
orderstring{{ORDER}}

Response

Response Example

                    {
 "data": [
 {
 "id": "31162",
 "status": "3",
 "status_name": "Finished",
 "status_period": null,
 "pitch": null,
 "referee_id": "22",
 "round_id": "1994",
 "season_id": "406",
 "season_name": "19/20",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": "1446",
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2019-08-16 18:30:00",
 "date": "2019-08-16",
 "time": "18:30:00",
 "minute": 90,
 "timestamp": 1565973000,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "111",
 "name": "FC Bayern Munich",
 "short_code": "FCB",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/111.png",
 "form": null,
 "coach_id": "3757",
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "2806",
 "name": "Hertha BSC",
 "short_code": "BSC",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/2806.png",
 "form": null,
 "coach_id": "3189",
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": "594",
 "name": "Bundesliga",
 "type": "",
 "country_id": "4",
 "country_name": "Germany",
 "country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
 },
 "scores": {
 "home_score": "2",
 "away_score": "2",
 "ht_score": "1-2",
 "ft_score": "2-2",
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0"
 },
 "weather_report": false
 },
 {
 "id": "31177",
 "status": "3",
 "status_name": "Finished",
 "status_period": null,
 "pitch": null,
 "referee_id": "403",
 "round_id": "1995",
 "season_id": "406",
 "season_name": "19/20",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": "1626",
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2019-08-24 16:30:00",
 "date": "2019-08-24",
 "time": "16:30:00",
 "minute": 90,
 "timestamp": 1566657000,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "2816",
 "name": "FC Schalke 04",
 "short_code": "S04",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/2816.png",
 "form": null,
 "coach_id": "664",
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "111",
 "name": "FC Bayern Munich",
 "short_code": "FCB",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/111.png",
 "form": null,
 "coach_id": "3757",
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": "594",
 "name": "Bundesliga",
 "type": "",
 "country_id": "4",
 "country_name": "Germany",
 "country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
 },
 "scores": {
 "home_score": "0",
 "away_score": "3",
 "ht_score": "0-1",
 "ft_score": "0-3",
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0"
 },
 "weather_report": false
 },
 {
 "id": "31185",
 "status": "3",
 "status_name": "Finished",
 "status_period": null,
 "pitch": null,
 "referee_id": "473",
 "round_id": "1996",
 "season_id": "406",
 "season_name": "19/20",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": "1446",
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2019-08-31 13:30:00",
 "date": "2019-08-31",
 "time": "13:30:00",
 "minute": 90,
 "timestamp": 1567251000,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "111",
 "name": "FC Bayern Munich",
 "short_code": "FCB",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/111.png",
 "form": null,
 "coach_id": "3757",
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "2813",
 "name": "1. FSV Mainz 05",
 "short_code": "M05",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/2813.png",
 "form": null,
 "coach_id": "3577",
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": "594",
 "name": "Bundesliga",
 "type": "",
 "country_id": "4",
 "country_name": "Germany",
 "country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
 },
 "scores": {
 "home_score": "6",
 "away_score": "1",
 "ht_score": "2-1",
 "ft_score": "6-1",
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0"
 },
 "weather_report": false
 },
 {
 "id": "31195",
 "status": "3",
 "status_name": "Finished",
 "status_period": null,
 "pitch": null,
 "referee_id": "405",
 "round_id": "1997",
 "season_id": "406",
 "season_name": "19/20",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": "91",
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2019-09-14 16:30:00",
 "date": "2019-09-14",
 "time": "16:30:00",
 "minute": 90,
 "timestamp": 1568471400,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "101",
 "name": "RB Leipzig",
 "short_code": "RBL",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/101.png",
 "form": null,
 "coach_id": "57",
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "111",
 "name": "FC Bayern Munich",
 "short_code": "FCB",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/111.png",
 "form": null,
 "coach_id": "3757",
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": "594",
 "name": "Bundesliga",
 "type": "",
 "country_id": "4",
 "country_name": "Germany",
 "country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
 },
 "scores": {
 "home_score": "1",
 "away_score": "1",
 "ht_score": "1-1",
 "ft_score": "1-1",
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0"
 },
 "weather_report": false
 },
...

Test Endpoint

Fixtures by Season / Group

The Fixtures by Season / Group Endpoint gives you fixtures from a single Group

GETFixtures By Season ID and Group

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringstage
season_idinteger{{SEASON_ID}}
group_idinteger{{GROUP_ID}}
orderstring{{ORDER}}

Response

Response Example

                    {
 "data": [
 {
 "id": 1286443,
 "status": "3",
 "status_name": "Finished",
 "status_period": null,
 "pitch": null,
 "referee_id": null,
 "round_id": "128037",
 "round_name": "5",
 "season_id": "7169",
 "season_name": "2021",
 "stage_id": "1",
 "stage_name": "Regular Season",
 "group_id": "1",
 "group_name": "Apertura",
 "aggregate_id": null,
 "winner_team_id": "19364",
 "venue_id": "5695",
 "leg": null,
 "week": "38",
 "deleted": "0",
 "time": {
 "datetime": "2020-09-16 02:05:00",
 "date": "2020-09-16",
 "time": "02:05:00",
 "minute": 90,
 "timestamp": 1600214700,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "19364",
 "name": "Tepatitlan FC",
 "short_code": "TEP",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/19364.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "6946",
 "name": "Venados FC",
 "short_code": "VDS",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/6946.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": "4178",
 "name": "Liga de Expansion MX, Apertura",
 "type": "",
 "country_id": "76",
 "country_name": "Mexico",
 "country_flag": "https://cdn.soccersapi.com/images/countries/30/mx.png"
 },
 "scores": {
 "home_score": "2",
 "away_score": "0",
 "ht_score": "0-0",
 "ft_score": "2-0",
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0",
 "has_standings": "1"
 },
 "weather_report": false
 },
...

Test Endpoint

Fixtures by Season / Group / Team

The Fixtures by Season / Group / Team Endpoint gives you fixtures from a single Team from a specific Group

GETFixtures By Season ID, Group and Team ID

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringstage
season_idinteger{{SEASON_ID}}
group_idinteger{{GROUP_ID}}
orderstring{{ORDER}}

Response

Response Example

                     {
 "data": [
 {
 "id": 65738,
 "status": "3",
 "status_name": "Finished",
 "status_period": null,
 "pitch": null,
 "referee_id": null,
 "round_id": "5787",
 "season_id": "8653",
 "season_name": "2019",
 "stage_id": "4",
 "stage_name": "Stage 1",
 "group_id": "91",
 "group_name": "Gr. H",
 "aggregate_id": null,
 "winner_team_id": "5110",
 "venue_id": null,
 "leg": null,
 "deleted": "0",
 "time": {
 "datetime": "2019-08-29 17:30:00",
 "date": "2019-08-29",
 "time": "17:30:00",
 "minute": 90,
 "timestamp": 1567092600,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "5496",
 "name": "Lithuania (W)",
 "short_code": "LIT",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/5496.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "5110",
 "name": "Croatia (W)",
 "short_code": "CRO",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/5110.png",
 "form": null,
 "coach_id": null,
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": "376",
 "name": "Euro Qualification Women",
 "type": null,
 "country_id": "135",
 "country_name": "Europe",
 "country_flag": null
 },
 "scores": {
 "home_score": "1",
 "away_score": "2",
 "ht_score": "0-1",
 "ft_score": "1-2",
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0",
 "has_standings": "1"
 },
 "weather_report": false
 },
...

Test Endpoint

Fixtures by Season / Stage / Team

The Fixtures by Stage Endpoint gives you fixtures from a single stage and Team

GETFixtures by Season ID, Stage ID and Team ID

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringstage
season_idinteger{{SEASON_ID}}
stage_idinteger{{STAGE_ID}}
team_idinteger{{TEAM_ID}}
orderstring{{ORDER}}

Response

Response Example

                     {
 "data": [
 {
 "id": 11352866,
 "status": 3,
 "pitch": null,
 "referee_id": 16716,
 "round_id": 159790,
 "season_id": 15512,
 "stage_id": 77441847,
 "group_id": 207832,
 "aggregate_id": null,
 "winner_team_id": 18683,
 "venue_id": 1353,
 "leg": "1/1",
 "deleted": false,
 "time": {
 "datetime": "2019-03-22 19:45:00",
 "date": "2019-03-22",
 "time": "19:45:00",
 "minute": 90,
 "timestamp": 1553283900,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": 18683
 },
 "away": {
 "id": 18756
 }
 },
 "league": {
 "id": 1363
 },
 "scores": {
 "home_score": 5,
 "away_score": 0,
 "ht_score": "2-0",
 "ft_score": "5-0",
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": 3,
 "away_position": 2
 },
 "assistants": {
 "first_assistant_id": 12895,
 "second_assistant_id": 12899,
 "fourth_assistant_id": null
 }
 },
 {
 "id": 11352868,
 "status": 3,
 "pitch": null,
 "referee_id": 17830,
 "round_id": 159791,
 "season_id": 15512,
 "stage_id": 77441847,
 "group_id": 207832,
 "aggregate_id": null,
 "winner_team_id": 18683,
 "venue_id": 3638,
 "leg": "1/1",
 "deleted": false,
 "time": {
 "datetime": "2019-03-25 19:45:00",
 "date": "2019-03-25",
 "time": "19:45:00",
 "minute": 90,
 "timestamp": 1553543100,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": 18874
 },
 "away": {
 "id": 18683
 }
 },
 "league": {
 "id": 1363
 },
 "scores": {
 "home_score": 1,
 "away_score": 5,
 "ht_score": "1-2",
 "ft_score": "1-5",
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": 3,
 "away_position": 1
 },
 "assistants": {
 "first_assistant_id": 17832,
 "second_assistant_id": 17834,
 "fourth_assistant_id": null
 }
 },
 {
 "id": 11352875,
 "status": 3,
 "pitch": null,
 "referee_id": 14381,
 "round_id": 159794,
 "season_id": 15512,
 "stage_id": 77441847,
 "group_id": 207832,
 "aggregate_id": null,
 "winner_team_id": 18683,
 "venue_id": 1353,
 "leg": "1/1",
 "deleted": false,
 "time": {
 "datetime": "2019-09-07 16:00:00",
 "date": "2019-09-07",
 "time": "16:00:00",
 "minute": 90,
 "timestamp": 1567872000,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": 18683
 },
 "away": {
 "id": 18728
 }
 },
 "league": {
 "id": 1363
 },
 "scores": {
 "home_score": 4,
 "away_score": 0,
 "ht_score": "1-0",
 "ft_score": "4-0",
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": 1,
 "away_position": 4
 },
 "assistants": {
 "first_assistant_id": 12785,
 "second_assistant_id": 17901,
 "fourth_assistant_id": null
 }
 },
...

Test Endpoint

Fixtures by Round

The Fixtures by Round Endpoint gives you fixtures from a single round

GETFixtures By Round ID

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringround
round_idinteger{{ROUND_ID}}

Response

Response Example

                     {
 "data": [
 {
 "id": "31162",
 "status": "3",
 "status_name": "Finished",
 "status_period": null,
 "pitch": null,
 "referee_id": "22",
 "round_id": "1994",
 "season_id": "406",
 "season_name": "19/20",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": "1446",
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2019-08-16 18:30:00",
 "date": "2019-08-16",
 "time": "18:30:00",
 "minute": 90,
 "timestamp": 1565973000,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "111",
 "name": "FC Bayern Munich",
 "short_code": "FCB",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/111.png",
 "form": null,
 "coach_id": "3757",
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "2806",
 "name": "Hertha BSC",
 "short_code": "BSC",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/2806.png",
 "form": null,
 "coach_id": "3189",
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": "594",
 "name": "Bundesliga",
 "type": "",
 "country_id": "4",
 "country_name": "Germany",
 "country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
 },
 "scores": {
 "home_score": "2",
 "away_score": "2",
 "ht_score": "1-2",
 "ft_score": "2-2",
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0"
 },
 "weather_report": false
 },
 {
 "id": "31163",
 "status": "3",
 "status_name": "Finished",
 "status_period": null,
 "pitch": null,
 "referee_id": "80",
 "round_id": "1994",
 "season_id": "406",
 "season_name": "19/20",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": "1386",
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2019-08-17 13:30:00",
 "date": "2019-08-17",
 "time": "13:30:00",
 "minute": 90,
 "timestamp": 1566041400,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "114",
 "name": "Bayer 04 Leverkusen",
 "short_code": "B04",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/114.png",
 "form": null,
 "coach_id": "54",
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "2807",
 "name": "SC Paderborn 07",
 "short_code": "PAD",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/2807.png",
 "form": null,
 "coach_id": "59",
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": "594",
 "name": "Bundesliga",
 "type": "",
 "country_id": "4",
 "country_name": "Germany",
 "country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
 },
 "scores": {
 "home_score": "3",
 "away_score": "2",
 "ht_score": "2-2",
 "ft_score": "3-2",
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0"
 },
 "weather_report": false
 },
 {
 "id": "31164",
 "status": "3",
 "status_name": "Finished",
 "status_period": null,
 "pitch": null,
 "referee_id": "434",
 "round_id": "1994",
 "season_id": "406",
 "season_name": "19/20",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": "1388",
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2019-08-17 13:30:00",
 "date": "2019-08-17",
 "time": "13:30:00",
 "minute": 90,
 "timestamp": 1566041400,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "2808",
 "name": "VfL Wolfsburg",
 "short_code": "WOB",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/2808.png",
 "form": null,
 "coach_id": "62",
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "2809",
 "name": "1. FC Cologne",
 "short_code": "KOE",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/2809.png",
 "form": null,
 "coach_id": "663",
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": "594",
 "name": "Bundesliga",
 "type": "",
 "country_id": "4",
 "country_name": "Germany",
 "country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
 },
 "scores": {
 "home_score": "2",
 "away_score": "1",
 "ht_score": "1-0",
 "ft_score": "2-1",
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0"
 },
 "weather_report": false
 },
...

Test Endpoint

Fixtures by Round / Team

The Fixtures by Round Endpoint gives you fixtures from a single round and Team

GETFixtures By Round ID and Team ID

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringround
round_idinteger{{ROUND_ID}}
team_idinteger{{TEAM_ID}}

Response

Response Example

                     {
 "data": [
 {
 "id": "31162",
 "status": "3",
 "status_name": "Finished",
 "status_period": null,
 "pitch": null,
 "referee_id": "22",
 "round_id": "1994",
 "season_id": "406",
 "season_name": "19/20",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": "1446",
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2019-08-16 18:30:00",
 "date": "2019-08-16",
 "time": "18:30:00",
 "minute": 90,
 "timestamp": 1565973000,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "111",
 "name": "FC Bayern Munich",
 "short_code": "FCB",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/111.png",
 "form": null,
 "coach_id": "3757",
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "2806",
 "name": "Hertha BSC",
 "short_code": "BSC",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/2806.png",
 "form": null,
 "coach_id": "3189",
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": "594",
 "name": "Bundesliga",
 "type": "",
 "country_id": "4",
 "country_name": "Germany",
 "country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
 },
 "scores": {
 "home_score": "2",
 "away_score": "2",
 "ht_score": "1-2",
 "ft_score": "2-2",
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "0",
 "has_tvs": "0"
 },
 "weather_report": false
 }
 ],
...

Test Endpoint

Match by ID

The Match by ID Endpoint gives you information from a specific match

GETMatch By ID

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringinfo
idinteger{{MATCH_ID}}

Response

Response Example

                    {
 "data": {
 "id": "15006543",
 "status": "3",
 "status_name": "Finished",
 "status_period": null,
 "pitch": null,
 "referee_id": "372",
 "round_id": null,
 "season_id": "406",
 "season_name": "19/20",
 "stage_id": null,
 "stage_name": null,
 "group_id": null,
 "group_name": null,
 "aggregate_id": null,
 "winner_team_id": null,
 "venue_id": "1216",
 "leg": null,
 "deleted": null,
 "time": {
 "datetime": "2020-05-16 15:30:00",
 "date": "2020-05-16",
 "time": "15:30:00",
 "minute": 90,
 "timestamp": 1589635800,
 "timezone": "UTC"
 },
 "teams": {
 "home": {
 "id": "98",
 "name": "Borussia Dortmund",
 "short_code": "BVB",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/98.png",
 "form": "3-4-3",
 "coach_id": "1007",
 "color": null,
 "kit_colors": null
 },
 "away": {
 "id": "2816",
 "name": "FC Schalke 04",
 "short_code": "S04",
 "img": "https://cdn.soccersapi.com/images/soccer/teams/80/2816.png",
 "form": "3-4-3",
 "coach_id": "664",
 "color": null,
 "kit_colors": null
 }
 },
 "league": {
 "id": "594",
 "name": "Bundesliga",
 "type": "",
 "country_id": "4",
 "country_name": "Germany",
 "country_flag": "https://cdn.soccersapi.com/images/countries/30/de.png"
 },
 "scores": {
 "home_score": "4",
 "away_score": "0",
 "ht_score": "2-0",
 "ft_score": "4-0",
 "et_score": null,
 "ps_score": null
 },
 "standings": {
 "home_position": null,
 "away_position": null
 },
 "assistants": {
 "first_assistant_id": null,
 "second_assistant_id": null,
 "fourth_assistant_id": null
 },
 "coverage": {
 "has_lineups": "1",
 "has_tvs": "1"
 },
 "weather_report": false
 },
...

Test Endpoint

Match Commentary

The Match Commentary Endpoint gives you commentaries by Match ID

GETMatch Commentary By Match ID

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringmatch_comments
idinteger{{MATCH_ID}}
orderstring{{ASC / DESC}}

Response

Response Example

                     {
 "data": [
 {
 "important": 0,
 "order": 47,
 "goal": 0,
 "minute": -1,
 "extra_minute": 0,
 "comment": "[59] spectators have come along to [24] today."
 },
 {
 "important": 0,
 "order": 2,
 "goal": 0,
 "minute": 0,
 "extra_minute": 0,
 "comment": "Today's referee, Deniz Aytekin, has blown to start the match."
 },
 {
 "important": 0,
 "order": 1,
 "goal": 0,
 "minute": 1,
 "extra_minute": 0,
 "comment": "Today's referee, Deniz Aytekin, has blown to start the match."
 },
 {
 "important": 0,
 "order": 3,
 "goal": 0,
 "minute": 4,
 "extra_minute": 0,
 "comment": "Dortmund awarded a free kick in their own half."
 },
 {
 "important": 0,
 "order": 4,
 "goal": 0,
 "minute": 6,
 "extra_minute": 0,
 "comment": "Deniz Aytekin signals a free kick to Schalke."
 },
 {
 "important": 0,
 "order": 5,
 "goal": 0,
 "minute": 7,
 "extra_minute": 0,
 "comment": "Schalke's Daniel Caligiuri gets in a shot but it is blocked by a Dortmund defender."
 },
 {
 "important": 0,
 "order": 6,
 "goal": 0,
 "minute": 7,
 "extra_minute": 0,
 "comment": "Thorgan Hazard for Dortmund gets in a strike but fails to hit the target."
 },
 {
 "important": 0,
 "order": 7,
 "goal": 0,
 "minute": 7,
 "extra_minute": 0,
 "comment": "It's a goal kick for the away team in Dortmund."
 },
 {
 "important": 0,
 "order": 8,
 "goal": 0,
 "minute": 8,
 "extra_minute": 0,
 "comment": "Can Dortmund get the ball into an attacking position from this throw-in in Schalke's half?"
 },
 {
 "important": 0,
 "order": 9,
 "goal": 0,
 "minute": 8,
 "extra_minute": 0,
 "comment": "Throw-in for Schalke in their own half."
 },
 {
 "important": 0,
 "order": 10,
 "goal": 0,
 "minute": 9,
 "extra_minute": 0,
 "comment": "Schalke awarded a throw-in in their own half."
 },
 {
 "important": 0,
 "order": 11,
 "goal": 0,
 "minute": 10,
 "extra_minute": 0,
 "comment": "Free kick Dortmund."
 },
 {
 "important": 0,
 "order": 12,
 "goal": 0,
 "minute": 11,
 "extra_minute": 0,
 "comment": "Deniz Aytekin awards Schalke a goal kick."
 },
 {
 "important": 0,
 "order": 13,
 "goal": 0,
 "minute": 12,
 "extra_minute": 0,
 "comment": "Throw-in for Schalke at Signal Iduna Park."
 },
 {
 "important": 0,
 "order": 14,
 "goal": 0,
 "minute": 13,
 "extra_minute": 0,
 "comment": "Ball safe as Schalke is awarded a throw-in in their half."
 },
 {
 "important": 0,
 "order": 15,
 "goal": 0,
 "minute": 15,
 "extra_minute": 0,
 "comment": "Raphael Guerreiro (Dortmund) gets in a strike but the shot is blocked by a defender."
 },
 {
 "important": 0,
 "order": 16,
 "goal": 0,
 "minute": 16,
 "extra_minute": 0,
 "comment": "Corner awarded to Dortmund."
 },
 {
 "important": 0,
 "order": 17,
 "goal": 0,
 "minute": 16,
 "extra_minute": 0,
 "comment": "A throw-in for the home team on the opposite half."
 },
 {
 "important": 0,
 "order": 18,
 "goal": 0,
 "minute": 17,
 "extra_minute": 0,
 "comment": "Free kick for Schalke in their own half."
 },
 {
 "important": 0,
 "order": 19,
 "goal": 0,
 "minute": 18,
 "extra_minute": 0,
 "comment": "Dortmund have a goal kick."
 },
 {
 "important": 0,
 "order": 20,
 "goal": 0,
 "minute": 18,
 "extra_minute": 0,
 "comment": "Throw-in Dortmund."
 },
 {
 "important": 0,
 "order": 21,
 "goal": 0,
 "minute": 19,
 "extra_minute": 0,
 "comment": "Deniz Aytekin awards the away team a throw-in."
 },
 {
 "important": 0,
 "order": 22,
 "goal": 0,
 "minute": 20,
 "extra_minute": 0,
 "comment": "Deniz Aytekin signals a free kick to Dortmund in their own half."
 },
 {
 "important": 0,
 "order": 23,
 "goal": 0,
 "minute": 20,
 "extra_minute": 0,
 "comment": "Dortmund to take a throw-in in Schalke territory."
 },
 {
 "important": 0,
 "order": 24,
 "goal": 0,
 "minute": 21,
 "extra_minute": 0,
 "comment": "Throw-in for Schalke in their own half."
 },
 {
 "important": 0,
 "order": 25,
 "goal": 0,
 "minute": 22,
 "extra_minute": 0,
 "comment": "Deniz Aytekin signals a Dortmund throw-in in Schalke's half."
 },
 {
 "important": 0,
 "order": 26,
 "goal": 0,
 "minute": 22,
 "extra_minute": 0,
 "comment": "Deniz Aytekin signals a free kick to Dortmund just outside Schalke's area."
 },
 {
 "important": 0,
 "order": 27,
 "goal": 0,
 "minute": 23,
 "extra_minute": 0,
 "comment": "Dortmund push forward at Signal Iduna Park and Achraf Hakimi gets in a strike. This is blocked, however, by a determined Schalke defence."
 },
 {
 "important": 0,
 "order": 28,
 "goal": 0,
 "minute": 24,
 "extra_minute": 0,
 "comment": "Dortmund have been awarded a corner by Deniz Aytekin."
 },
 {
 "important": 0,
 "order": 29,
 "goal": 0,
 "minute": 24,
 "extra_minute": 0,
 "comment": "Erling Haaland of Dortmund gets in a strike, but is off target."
 },
 {
 "important": 0,
 "order": 30,
 "goal": 0,
 "minute": 24,
 "extra_minute": 0,
 "comment": "Goal kick for Schalke at Signal Iduna Park."
 },
 {
 "important": 0,
 "order": 31,
 "goal": 0,
 "minute": 26,
 "extra_minute": 0,
 "comment": "Schalke pushes forward through Daniel Caligiuri, whose finish on goal is saved."
 },
...

Test Endpoint

Match Events

The Match Events Endpoint gives the list ofevents / occurrences by Match ID

GETMatch Events By Match ID

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringmatch_events
idstring{{MATCH_ID}}

Response

Response Example

                    {
 "data": [
 {
 "team_id": "98",
 "type": "goal",
 "player_id": "13201",
 "player_name": "Haaland, Erling",
 "related_player_id": 94286,
 "related_player_name": "Hazard, Thorgan",
 "minute": 29,
 "extra_minute": null,
 "reason": null,
 "injuried": null,
 "result": "1-0"
 },
 {
 "team_id": "2816",
 "type": "injury",
 "player_id": "12115",
 "player_name": "Todibo, Jean-Clair",
 "related_player_id": null,
 "related_player_name": null,
 "minute": 36,
 "extra_minute": null,
 "reason": null,
 "injuried": true,
 "result": null
 },
 {
 "team_id": "98",
 "type": "goal",
 "player_id": "13190",
 "player_name": "Guerreiro, Raphael",
 "related_player_id": 226978,
 "related_player_name": "Brandt, Julian",
 "minute": 45,
 "extra_minute": null,
 "reason": null,
 "injuried": null,
 "result": "2-0"
 },
 {
 "team_id": "2816",
 "type": "substitution",
 "player_id": "8269",
 "player_name": "Raman, Benito",
 "related_player_id": "8325",
 "related_player_name": "Matondo, Rabbi",
 "minute": 46,
 "extra_minute": null,
 "reason": null,
 "injuried": null,
 "result": null
 },
 {
 "team_id": "2816",
 "type": "substitution",
 "player_id": "12115",
 "player_name": "Todibo, Jean-Clair",
 "related_player_id": "8274",
 "related_player_name": "Burgstaller, Guido",
 "minute": 46,
 "extra_minute": null,
 "reason": null,
 "injuried": null,
 "result": null
 },
 {
 "team_id": "2816",
 "type": "yellowcard",
 "player_id": "19999",
 "player_name": "Sane, Salif",
 "related_player_id": null,
 "related_player_name": null,
 "minute": 48,
 "extra_minute": null,
 "reason": null,
 "injuried": null,
 "result": null
 },
 {
 "team_id": "98",
 "type": "goal",
 "player_id": "13191",
 "player_name": "Hazard, Thorgan",
 "related_player_id": 226978,
 "related_player_name": "Brandt, Julian",
 "minute": 48,
 "extra_minute": null,
 "reason": null,
 "injuried": null,
 "result": "3-0"
 },
 {
 "team_id": "98",
 "type": "injury",
 "player_id": "13201",
 "player_name": "Haaland, Erling",
 "related_player_id": null,
 "related_player_name": null,
 "minute": 49,
 "extra_minute": null,
 "reason": null,
 "injuried": true,
 "result": null
 },
 {
 "team_id": "98",
 "type": "yellowcard",
 "player_id": "22763",
 "player_name": "Delaney, Thomas",
 "related_player_id": null,
 "related_player_name": null,
 "minute": 53,
 "extra_minute": null,
 "reason": null,
 "injuried": null,
 "result": null
 },
...

Test Endpoint

Match Lineups

The Lineups Endpoint gives you starting Lineups by Match ID

GETLineups By Match ID

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringmatch_lineups
idstring{{MATCH_ID}}

Response

Response Example

                    {
 "data": {
 "home": {
 "formation": "3-4-3",
 "confirmed_formation": 1,
 "squad": [
 {
 "player": {
 "id": "13183",
 "name": null,
 "common_name": "Burki, Roman",
 "firstname": "Roman",
 "lastname": "Burki",
 "weight": "85",
 "height": "187",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/13183.png",
 "country": {
 "id": "114",
 "name": "Switzerland",
 "cc": "ch"
 }
 },
 "number": "1",
 "captain": null,
 "position": "G",
 "order": 1
 },
 {
 "player": {
 "id": "13184",
 "name": null,
 "common_name": "Piszczek, Lukasz",
 "firstname": "Lukasz",
 "lastname": "Piszczek",
 "weight": "79",
 "height": "184",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/13184.png",
 "country": {
 "id": "95",
 "name": "Poland",
 "cc": "pl"
 }
 },
 "number": "26",
 "captain": null,
 "position": "D",
 "order": 2
 },
 {
 "player": {
 "id": "13185",
 "name": null,
 "common_name": "Hummels, Mats",
 "firstname": "Mats Julian",
 "lastname": "Hummels",
 "weight": "94",
 "height": "191",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/13185.png",
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "de"
 }
 },
 "number": "15",
 "captain": null,
 "position": "D",
 "order": 3
 },
 {
 "player": {
 "id": "13199",
 "name": null,
 "common_name": "Akanji, Manuel",
 "firstname": "Manuel Obafemi",
 "lastname": "Akanji",
 "weight": "91",
 "height": "187",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/13199.png",
 "country": {
 "id": "114",
 "name": "Switzerland",
 "cc": "ch"
 }
 },
 "number": "16",
 "captain": null,
 "position": "D",
 "order": 4
 },
 {
 "player": {
 "id": "13187",
 "name": null,
 "common_name": "Hakimi, Achraf",
 "firstname": "Achraf",
 "lastname": "Hakimi",
 "weight": "73",
 "height": "181",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/13187.png",
 "country": {
 "id": "79",
 "name": "Morocco",
 "cc": "ma"
 }
 },
 "number": "5",
 "captain": null,
 "position": "D",
 "order": 5
 },
 {
 "player": {
 "id": "13198",
 "name": null,
 "common_name": "Dahoud, Mahmoud",
 "firstname": "Mahmoud",
 "lastname": "Dahoud",
 "weight": "68",
 "height": "178",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/13198.png",
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "de"
 }
 },
 "number": "8",
 "captain": null,
 "position": "M",
 "order": 6
 },
 {
 "player": {
 "id": "22763",
 "name": null,
 "common_name": "Delaney, Thomas",
 "firstname": "Thomas",
 "lastname": "Delaney",
 "weight": null,
 "height": null,
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/22763.png",
 "country": {
 "id": null,
 "name": null,
 "cc": null
 }
 },
 "number": "6",
 "captain": null,
 "position": "M",
 "order": 7
 },
 {
 "player": {
 "id": "13190",
 "name": null,
 "common_name": "Guerreiro, Raphael",
 "firstname": "Raphael Adelino",
 "lastname": "Jose Guerreiro",
 "weight": "71",
 "height": "170",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/13190.png",
 "country": {
 "id": "96",
 "name": "Portugal",
 "cc": "pt"
 }
 },
 "number": "13",
 "captain": null,
 "position": "D",
 "order": 8
 },
 {
 "player": {
 "id": "13192",
 "name": null,
 "common_name": "Brandt, Julian",
 "firstname": "Julian",
 "lastname": "Brandt",
 "weight": "83",
 "height": "185",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/13192.png",
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "de"
 }
 },
 "number": "19",
 "captain": null,
 "position": "M",
 "order": 9
 },
 {
 "player": {
 "id": "13201",
 "name": null,
 "common_name": "Haaland, Erling",
 "firstname": "Erling Braut",
 "lastname": "Haaland",
 "weight": "87",
 "height": "194",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/13201.png",
 "country": {
 "id": "87",
 "name": "Norway",
 "cc": "no"
 }
 },
 "number": "17",
 "captain": null,
 "position": "F",
 "order": 10
 },
 {
 "player": {
 "id": "13191",
 "name": null,
 "common_name": "Hazard, Thorgan",
 "firstname": "Thorgan Ganael Francis",
 "lastname": "Hazard",
 "weight": "71",
 "height": "175",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/13191.png",
 "country": {
 "id": "21",
 "name": "Belgium",
 "cc": "be"
 }
 },
 "number": "23",
 "captain": null,
 "position": "M",
 "order": 11
 }
 ]
 },
 "away": {
 "formation": "3-4-3",
 "confirmed_formation": 1,
 "squad": [
 {
 "player": {
 "id": "12113",
 "name": null,
 "common_name": "Schubert, Markus",
 "firstname": "Markus",
 "lastname": "Schubert",
 "weight": "81",
 "height": "184",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/12113.png",
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "de"
 }
 },
 "number": "23",
 "captain": null,
 "position": "G",
 "order": 1
 },
 {
 "player": {
 "id": "12115",
 "name": null,
 "common_name": "Todibo, Jean-Clair",
 "firstname": "Jean-Clair",
 "lastname": "Todibo",
 "weight": "81",
 "height": "190",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/12115.png",
 "country": {
 "id": "7",
 "name": "France",
 "cc": "fr"
 }
 },
 "number": "21",
 "captain": null,
 "position": "D",
 "order": 2
 },
 {
 "player": {
 "id": "19999",
 "name": null,
 "common_name": "Sane, Salif",
 "firstname": "Salif",
 "lastname": "Sane",
 "weight": "84",
 "height": "196",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/19999.png",
 "country": {
 "id": "105",
 "name": "Senegal",
 "cc": "sn"
 }
 },
 "number": "26",
 "captain": null,
 "position": "D",
 "order": 3
 },
 {
 "player": {
 "id": "8273",
 "name": null,
 "common_name": "Nastasic, Matija",
 "firstname": "Matija",
 "lastname": "Nastasic",
 "weight": "83",
 "height": "188",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/8273.png",
 "country": {
 "id": "106",
 "name": "Serbia",
 "cc": "rs"
 }
 },
 "number": "5",
 "captain": null,
 "position": "D",
 "order": 4
 },
...

Test Endpoint

Match Bench

The Match Bench Endpoint gives you the bench of both teams

GETBench By Match ID

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringmatch_bench
idstring{{MATCH_ID}}

Response

Response Example

                    {
 "data": {
 "home": [
 {
 "player": {
 "id": "13193",
 "name": null,
 "common_name": "Hitz, Marwin",
 "firstname": "Marwin",
 "lastname": "Hitz",
 "weight": "89",
 "height": "194",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/13193.png",
 "country": {
 "id": "114",
 "name": "Switzerland",
 "cc": "ch"
 }
 },
 "number": "35",
 "position": "G"
 },
 {
 "player": {
 "id": "21924",
 "name": null,
 "common_name": "Fuhrich, Chris",
 "firstname": "Chris",
 "lastname": "Fuhrich",
 "weight": "0",
 "height": "178",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/21924.png",
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "de"
 }
 },
 "number": "33",
 "position": "M"
 },
 {
 "player": {
 "id": "6260",
 "name": null,
 "common_name": "Sancho, Jadon",
 "firstname": "Jadon Malik",
 "lastname": "Sancho",
 "weight": "76",
 "height": "180",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/6260.png",
 "country": {
 "id": "3",
 "name": "England",
 "cc": "en"
 }
 },
 "number": "7",
 "position": "M"
 },
 {
 "player": {
 "id": "21995",
 "name": null,
 "common_name": "Raschl, Tobias",
 "firstname": "Tobias",
 "lastname": "Raschl",
 "weight": "75",
 "height": "177",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/21995.png",
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "de"
 }
 },
 "number": "37",
 "position": "M"
 },
 {
 "player": {
 "id": "13194",
 "name": null,
 "common_name": "Morey, Mateu",
 "firstname": "Mateu Jaume",
 "lastname": "Morey Bauza",
 "weight": "67",
 "height": "173",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/13194.png",
 "country": {
 "id": "5",
 "name": "Spain",
 "cc": "es"
 }
 },
 "number": "22",
 "position": "D"
 },
 {
 "player": {
 "id": "13195",
 "name": null,
 "common_name": "Balerdi, Leonardo",
 "firstname": "Leonardo Julian",
 "lastname": "Balerdi Rosa",
 "weight": "76",
 "height": "187",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/13195.png",
 "country": {
 "id": "12",
 "name": "Argentina",
 "cc": "ar"
 }
 },
 "number": "18",
 "position": "D"
 },
 {
 "player": {
 "id": "13196",
 "name": null,
 "common_name": "Reyna, Giovanni",
 "firstname": "Giovanni Alejandro",
 "lastname": "Reyna",
 "weight": "0",
 "height": "183",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/13196.png",
 "country": {
 "id": "124",
 "name": "USA",
 "cc": "us"
 }
 },
 "number": "32",
 "position": "F"
 },
 {
 "player": {
 "id": "13197",
 "name": null,
 "common_name": "Schmelzer,Marcel",
 "firstname": "Marcel",
 "lastname": "Schmelzer",
 "weight": "74",
 "height": "180",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/13197.png",
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "de"
 }
 },
 "number": "29",
 "position": "D"
 },
 {
 "player": {
 "id": "16623",
 "name": null,
 "common_name": "Gotze, Mario",
 "firstname": "Mario",
 "lastname": "Gotze",
 "weight": "75",
 "height": "176",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/16623.png",
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "de"
 }
 },
 "number": "10",
 "position": "M"
 }
 ],
 "away": [
 {
 "player": {
 "id": "12107",
 "name": null,
 "common_name": "Nubel, Alexander",
 "firstname": "Alexander",
 "lastname": "Nubel",
 "weight": "85",
 "height": "193",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/12107.png",
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "de"
 }
 },
 "number": "10",
 "position": "M"
 },
 {
 "player": {
 "id": "30464",
 "name": null,
 "common_name": "Miranda, Juan",
 "firstname": "Juan",
 "lastname": "Miranda",
 "weight": null,
 "height": null,
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/30464.png",
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "de"
 }
 },
 "number": "10",
 "position": "M"
 },
 {
 "player": {
 "id": "8336",
 "name": null,
 "common_name": "Gregoritsch, Michael",
 "firstname": "Michael",
 "lastname": "Gregoritsch",
 "weight": "87",
 "height": "193",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/8336.png",
 "country": {
 "id": "15",
 "name": "Austria",
 "cc": "at"
 }
 },
 "number": "10",
 "position": "M"
 },
 {
 "player": {
 "id": "242",
 "name": null,
 "common_name": "Kutucu, Ahmed",
 "firstname": "Ahmed",
 "lastname": "Kutucu",
 "weight": "76",
 "height": "181",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/242.png",
 "country": {
 "id": "118",
 "name": "Turkey",
 "cc": "tr"
 }
 },
 "number": "10",
 "position": "M"
 },
 {
 "player": {
 "id": "12114",
 "name": null,
 "common_name": "Mercan, Munir Levent",
 "firstname": "Munir Levent",
 "lastname": "Mercan",
 "weight": "69",
 "height": "176",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/12114.png",
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "de"
 }
 },
 "number": "10",
 "position": "M"
 },
 {
 "player": {
 "id": "12111",
 "name": null,
 "common_name": "Schopf, Alessandro",
 "firstname": "Alessandro",
 "lastname": "Schopf",
 "weight": "73",
 "height": "178",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/12111.png",
 "country": {
 "id": "15",
 "name": "Austria",
 "cc": "at"
 }
 },
 "number": "10",
 "position": "M"
 },
...

Test Endpoint

Match by Multiple ID

The Match by Multiple ID Endpoint allows you to get info from up to 15 matches by passing multiple IDs

GETMatches by Multiple Match IDs

API Reference

URI Parameters

userstring{{USERNAME}}
tokenstring{{TOKEN}}
tstringsort
idsstring{{ID, ID, ID}}

Response

Response Example

                    {
    "data": [
        {
            "id": 1311114,
            "status": "3",
            "status_name": "Finished",
            "status_period": null,
            "pitch": null,
            "referee_id": null,
            "round_id": "5793",
            "round_name": "7",
            "season_id": "8653",
            "season_name": "2019",
            "stage_id": "4",
            "stage_name": "Stage 1",
            "group_id": "6",
            "group_name": "Group B",
            "aggregate_id": null,
            "winner_team_id": "3707",
            "venue_id": null,
            "leg": null,
            "week": "38",
            "deleted": "0",
            "time": {
                "datetime": "2020-09-17 16:00:00",
                "date": "2020-09-17",
                "time": "16:00:00",
                "minute": 90,
                "timestamp": 1600351200,
                "timezone": "UTC"
            },
            "teams": {
                "home": {
                    "id": 5121,
                    "name": "Bosnia & Herzegovina (W)",
                    "short_code": "BOH",
                    "img": "https://cdn.soccersapi.com/images/soccer/teams/80/5121.png",
                    "form": null,
                    "coach_id": "1697",
                    "kit_colors": null
                },
                "away": {
                    "id": 3707,
                    "name": "Denmark (W)",
                    "short_code": "DEN",
                    "img": "https://cdn.soccersapi.com/images/soccer/teams/80/3707.png",
                    "form": null,
                    "coach_id": "2663",
                    "kit_colors": null
                }
            },
            "league": {
                "id": 376,
                "name": "Euro Qualification Women",
                "type": null,
                "country_id": "135",
                "country_name": "Europe",
                "country_flag": null
            },
            "scores": {
                "home_score": "0",
                "away_score": "4",
                "ht_score": "0-3",
                "ft_score": "0-4",
                "et_score": null,
                "ps_score": null
            },
            "standings": {
                "home_position": 0,
                "away_position": 0
            },
            "assistants": {
                "first_assistant_id": null,
                "second_assistant_id": null,
                "fourth_assistant_id": null
            },
            "coverage": {
                "has_lineups": 0,
                "has_tvs": 0,
                "has_standings": 1
            },
            "weather_report": null
        },
        {
            "id": 1281416,
            "status": "3",
            "status_name": "Finished",
            "status_period": null,
            "pitch": null,
            "referee_id": null,
            "round_id": "127419",
            "round_name": "9",
            "season_id": "7130",
            "season_name": "20/21",
            "stage_id": "6",
            "stage_name": "Group stage",
            "group_id": null,
            "group_name": null,
            "aggregate_id": null,
            "winner_team_id": "10196",
            "venue_id": "2445",
            "leg": null,
            "week": "38",
            "deleted": "0",
            "time": {
                "datetime": "2020-09-16 19:00:00",
                "date": "2020-09-16",
                "time": "19:00:00",
                "minute": 90,
                "timestamp": 1600275600,
                "timezone": "UTC"
            },
            "teams": {
                "home": {
                    "id": 10196,
                    "name": "SV Grodig",
                    "short_code": "SVG",
                    "img": "https://cdn.soccersapi.com/images/soccer/teams/80/10196.png",
                    "form": null,
                    "coach_id": null,
                    "kit_colors": null
                },
                "away": {
                    "id": 6555,
                    "name": "SV Wals-Grunau",
                    "short_code": "WAL",
                    "img": "https://cdn.soccersapi.com/images/soccer/teams/80/6555.png",
                    "form": null,
                    "coach_id": null,
                    "kit_colors": null
                }
            },
            "league": {
                "id": 1041,
                "name": "Regionalliga West - Salzburg",
                "type": "",
                "country_id": "15",
                "country_name": "Austria",
                "country_flag": "https://cdn.soccersapi.com/images/countries/30/at.png"
            },
            "scores": {
                "home_score": "3",
                "away_score": "1",
                "ht_score": "1-0",
                "ft_score": "3-1",
                "et_score": null,
                "ps_score": null
            },
            "standings": {
                "home_position": 0,
                "away_position": 0
            },
            "assistants": {
                "first_assistant_id": null,
                "second_assistant_id": null,
                "fourth_assistant_id": null
            },
            "coverage": {
                "has_lineups": 0,
                "has_tvs": 0,
                "has_standings": 1
            },
            "weather_report": null
        },
...

Test Endpoint

Match Sidelined

The Match Sidelined endpoint give you information about missing players of both teams on a single match

GETMatch Sidelined by Match ID

API Reference

URI Parameters

userstring{{USERNAME}}
tokenstring{{TOKEN}}
tstringmatch_sidelined
idstring{{MATCH_ID}}

Response

Response Example

                    {
    "data": {
        "home": {
            "id": "98",
            "name": "Dortmund",
            "types": {
                "injuries": [
                    {
                        "player": {
                            "id": "13186",
                            "name": "Zagadou, Dan-Axel"
                        },
                        "reason": "Knee Problems",
                        "since": "2020-08-14",
                        "expected_return": "?"
                    },
                    {
                        "player": {
                            "id": "19989",
                            "name": "Reus, Marco"
                        },
                        "reason": "Tendonitis",
                        "since": "2020-07-30",
                        "expected_return": "?"
                    },
                    {
                        "player": {
                            "id": "13197",
                            "name": "Schmelzer,Marcel"
                        },
                        "reason": "Knee Surgery",
                        "since": "2020-07-15",
                        "expected_return": "?"
                    }
                ],
                "suspensions": [
                    {
                        "player": {
                            "id": "137486",
                            "name": "Moukoko, Youssoufa"
                        },
                        "reason": "No eligibility",
                        "since": "2020-07-01",
                        "expected_return": "2020-11-20"
                    }
                ]
            }
        },
        "away": null
    },
...

Test Endpoint

Match Stats

The Match Stats endpoint gives you the statistics of a single event

GETMatch Statistics By Match ID

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringmatch
idinteger{{MATCH_ID}}

Response

Response Example

                     {
 "data": [
 {
 "team_id": "98",
 "passes": {
 "total": null,
 "accurate": null,
 "percentage": null
 },
 "fouls": 9,
 "injuries": 3,
 "corners": 4,
 "offsides": 0,
 "shots_blocked": 4,
 "possessiontime": null,
 "possessionpercent": 57,
 "yellowcards": 2,
 "yellowredcards": 0,
 "redcards": 0,
 "substitutions": 4,
 "goal_kick": 7,
 "goal_attempts": 7,
 "free_kick": 9,
 "throw_in": 15,
 "ball_safe": 51,
 "goals": 4,
 "penalties": "0/0",
 "attacks": 22,
 "dangerous_attacks": 27
 },
 {
 "team_id": "2816",
 "passes": {
 "total": null,
 "accurate": null,
 "percentage": null
 },
 "fouls": 9,
 "injuries": 1,
 "corners": 1,
 "offsides": 4,
 "shots_blocked": 3,
 "possessiontime": null,
 "possessionpercent": 43,
 "yellowcards": 2,
 "yellowredcards": 0,
 "redcards": 0,
 "substitutions": 5,
 "goal_kick": 5,
 "goal_attempts": 7,
 "throw_in": 16,
 "ball_safe": 46,
 "goals": 0,
 "penalties": "0/0",
 "attacks": 29,
 "dangerous_attacks": 25
 }
 ],
...

Test Endpoint

League Stats

This endpoint allows you to get league stats by ID. By default it will return the current Season of the league

GETLeague Statistics by League ID (Current Season)

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringleague
idinteger{{LEAGUE_ID}}

Response

Response Example

                    {
 "data": {
 "season_id": 406,
 "league_id": 594,
 "number_of_teams": 18,
 "number_of_matches": 502,
 "team_most_scored": {
 "id": "111",
 "total_goals": 81
 },
 "player_most_scored": {
 "id": "19988",
 "total_goals": 27
 },
 "substituted_in": {
 "total": 862,
 "avg_per_match": 1.72,
 "avg_every_minutes": 52
 },
 "assists": {
 "total": 587,
 "avg_per_match": 1.17,
 "avg_every_minutes": 77
 },
 "cards": {
 "total": {
 "total": 978,
 "avg_per_match": 1.95,
 "avg_every_minutes": 46
 },
 "yellow": {
 "total": 932,
 "avg_per_match": 1.86,
 "avg_every_minutes": 48
 },
 "yellowred": {
 "total": 28,
 "avg_per_match": 0.06,
 "avg_every_minutes": 1614
 },
 "red": {
 "total": 18,
 "avg_per_match": 0.04,
 "avg_every_minutes": 2510
 }
 },
 "goals": {
 "overall": {
 "total": 812,
 "percentage_total_goals": 100,
 "avg_per_match": 1.62,
 "avg_every_minutes": 56
 },
 "home": {
 "total": 426,
 "percentage_total_goals": 52.46,
 "avg_per_match": 0.85,
 "avg_every_minutes": 106
 },
 "away": {
 "total": 386,
 "percentage_total_goals": 47.54,
 "avg_per_match": 0.77,
 "avg_every_minutes": 117
 }
 },
 "clean_sheets": {
 "overall": {
 "total": 115,
 "avg_total_goals": 22.91
 },
 "home": {
 "total": 65,
 "avg_total_goals": 12.95
 },
 "away": {
 "total": 50,
 "avg_total_goals": 9.96
 }
 },
 "goals_scored_range": {
 "0-15": {
 "total": 115,
 "percentage_total_goals": 14.16
 },
 "15-30": {
 "total": 89,
 "percentage_total_goals": 10.96
 },
 "30-45": {
 "total": 135,
 "percentage_total_goals": 16.63
 },
 "45-60": {
 "total": 147,
 "percentage_total_goals": 18.1
 },
 "60-75": {
 "total": 131,
 "percentage_total_goals": 16.13
 },
 "75-90": {
 "total": 195,
 "percentage_total_goals": 24.01
 },
 "90-120": {
 "total": 0,
 "percentage_total_goals": 0
 }
 },
 "goal_line": {
 "over": {
 "0.5": {
 "total": 478,
 "percentage_total_matches": 95.22
 },
 "1.5": {
 "total": 436,
 "percentage_total_matches": 86.85
 },
 "2.5": {
 "total": 334,
 "percentage_total_matches": 66.53
 },
 "3.5": {
 "total": 210,
 "percentage_total_matches": 41.83
 },
 "4.5": {
 "total": 102,
 "percentage_total_matches": 20.32
 },
 "5.5": {
 "total": 48,
 "percentage_total_matches": 9.56
 }
 },
 "under": {
 "0.5": {
 "total": 24,
 "percentage_total_matches": 4.78
 },
 "1.5": {
 "total": 24,
 "percentage_total_matches": 13.15
 },
 "2.5": {
 "total": 24,
 "percentage_total_matches": 33.47
 },
 "3.5": {
 "total": 24,
 "percentage_total_matches": 58.17
 },
 "4.5": {
 "total": 24,
 "percentage_total_matches": 79.68
 },
 "5.5": {
 "total": 24,
 "percentage_total_matches": 90.44
 }
 }
 }
 },
...

Test Endpoint

Season Stats

This endpoint allows you to get Season stats by ID.

GETSeason Statistics by Season ID

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringseason
idinteger{{SEASON_ID}}

Response

Response Example

                    {
 "data": {
 "season_id": 406,
 "league_id": 594,
 "number_of_teams": 18,
 "number_of_matches": 502,
 "team_most_scored": {
 "id": "111",
 "total_goals": 81
 },
 "player_most_scored": {
 "id": "19988",
 "total_goals": 27
 },
 "substituted_in": {
 "total": 862,
 "avg_per_match": 1.72,
 "avg_every_minutes": 52
 },
 "assists": {
 "total": 587,
 "avg_per_match": 1.17,
 "avg_every_minutes": 77
 },
 "cards": {
 "total": {
 "total": 978,
 "avg_per_match": 1.95,
 "avg_every_minutes": 46
 },
 "yellow": {
 "total": 932,
 "avg_per_match": 1.86,
 "avg_every_minutes": 48
 },
 "yellowred": {
 "total": 28,
 "avg_per_match": 0.06,
 "avg_every_minutes": 1614
 },
 "red": {
 "total": 18,
 "avg_per_match": 0.04,
 "avg_every_minutes": 2510
 }
 },
 "goals": {
 "overall": {
 "total": 812,
 "percentage_total_goals": 100,
 "avg_per_match": 1.62,
 "avg_every_minutes": 56
 },
 "home": {
 "total": 426,
 "percentage_total_goals": 52.46,
 "avg_per_match": 0.85,
 "avg_every_minutes": 106
 },
 "away": {
 "total": 386,
 "percentage_total_goals": 47.54,
 "avg_per_match": 0.77,
 "avg_every_minutes": 117
 }
 },
 "clean_sheets": {
 "overall": {
 "total": 115,
 "avg_total_goals": 22.91
 },
 "home": {
 "total": 65,
 "avg_total_goals": 12.95
 },
 "away": {
 "total": 50,
 "avg_total_goals": 9.96
 }
 },
 "goals_scored_range": {
 "0-15": {
 "total": 115,
 "percentage_total_goals": 14.16
 },
 "15-30": {
 "total": 89,
 "percentage_total_goals": 10.96
 },
 "30-45": {
 "total": 135,
 "percentage_total_goals": 16.63
 },
 "45-60": {
 "total": 147,
 "percentage_total_goals": 18.1
 },
 "60-75": {
 "total": 131,
 "percentage_total_goals": 16.13
 },
 "75-90": {
 "total": 195,
 "percentage_total_goals": 24.01
 },
 "90-120": {
 "total": 0,
 "percentage_total_goals": 0
 }
 },
 "goal_line": {
 "over": {
 "0.5": {
 "total": 478,
 "percentage_total_matches": 95.22
 },
 "1.5": {
 "total": 436,
 "percentage_total_matches": 86.85
 },
 "2.5": {
 "total": 334,
 "percentage_total_matches": 66.53
 },
 "3.5": {
 "total": 210,
 "percentage_total_matches": 41.83
 },
 "4.5": {
 "total": 102,
 "percentage_total_matches": 20.32
 },
 "5.5": {
 "total": 48,
 "percentage_total_matches": 9.56
 }
 },
 "under": {
 "0.5": {
 "total": 24,
 "percentage_total_matches": 4.78
 },
 "1.5": {
 "total": 24,
 "percentage_total_matches": 13.15
 },
 "2.5": {
 "total": 24,
 "percentage_total_matches": 33.47
 },
 "3.5": {
 "total": 24,
 "percentage_total_matches": 58.17
 },
 "4.5": {
 "total": 24,
 "percentage_total_matches": 79.68
 },
 "5.5": {
 "total": 24,
 "percentage_total_matches": 90.44
 }
 }
 }
 },
...

Test Endpoint

Team Stats

This endpoint allows you to get Team stats by Team ID and season ID.

GETTeam Statistics by Team ID and Season ID

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringteam
idinteger{{TEAM_ID}}
season_idinteger{{SEASON_ID}}

Response

Response Example

                    {
 "data": {
 "98": {
 "id": "98",
 "league_id": "594",
 "season_id": "406",
 "total_matches": 26,
 "assists": 65,
 "substituted_in": 52,
 "penalties": 2,
 "goals_scored": {
 "overall": {
 "total": 72,
 "avg": 2.77
 },
 "home": {
 "total": 45,
 "avg": 3.46
 },
 "away": {
 "total": 27,
 "avg": 2.08
 }
 },
 "goals_conceded": {
 "overall": {
 "total": 33,
 "avg": 1.27
 },
 "home": {
 "total": 10,
 "avg": 0.77
 },
 "away": {
 "total": 23,
 "avg": 1.77
 }
 },
 "clean_sheets": {
 "overall": {
 "total": 11,
 "avg": 33.33
 },
 "home": {
 "total": 8,
 "avg": 80
 },
 "away": {
 "total": 3,
 "avg": 13.04
 }
 },
 "cards": {
 "total": 28,
 "yellow": {
 "total": 27,
 "avg": 96.43
 },
 "yellowred": {
 "total": 1,
 "avg": 3.57
 },
 "redcards": {
 "total": 0,
 "avg": 0
 }
 },
 "goal_line": {
 "over": {
 "0.5": {
 "overall": {
 "total": 25,
 "avg": 96.15
 },
 "home": {
 "total": 13,
 "avg": 50
 },
 "away": {
 "total": 12,
 "avg": 46.15
 }
 },
 "1.5": {
 "overall": {
 "total": 23,
 "avg": 88.46
 },
 "home": {
 "total": 11,
 "avg": 42.31
 },
 "away": {
 "total": 12,
 "avg": 46.15
 }
 },
 "2.5": {
 "overall": {
 "total": 22,
 "avg": 84.62
 },
 "home": {
 "total": 11,
 "avg": 42.31
 },
 "away": {
 "total": 11,
 "avg": 42.31
 }
 },
 "3.5": {
 "overall": {
 "total": 18,
 "avg": 69.23
 },
 "home": {
 "total": 10,
 "avg": 38.46
 },
 "away": {
 "total": 8,
 "avg": 30.77
 }
 },
 "4.5": {
 "overall": {
 "total": 8,
 "avg": 30.77
 },
 "home": {
 "total": 6,
 "avg": 23.08
 },
 "away": {
 "total": 2,
 "avg": 7.69
 }
 },
 "5.5": {
 "overall": {
 "total": 6,
 "avg": 23.08
 },
 "home": {
 "total": 4,
 "avg": 15.38
 },
 "away": {
 "total": 2,
 "avg": 7.69
 }
 }
 },
 "under": {
 "0.5": {
 "overall": {
 "total": 1,
 "avg": 3.85
 },
 "home": {
 "total": 0,
 "avg": 0
 },
 "away": {
 "total": 1,
 "avg": 3.85
 }
 },
 "1.5": {
 "overall": {
 "total": 3,
 "avg": 11.54
 },
 "home": {
 "total": 2,
 "avg": 7.69
 },
 "away": {
 "total": 1,
 "avg": 3.85
 }
 },
 "2.5": {
 "overall": {
 "total": 4,
 "avg": 15.38
 },
 "home": {
 "total": 2,
 "avg": 7.69
 },
 "away": {
 "total": 2,
 "avg": 7.69
 }
 },
 "3.5": {
 "overall": {
 "total": 8,
 "avg": 30.77
 },
 "home": {
 "total": 3,
 "avg": 11.54
 },
 "away": {
 "total": 5,
 "avg": 19.23
 }
 },
 "4.5": {
 "overall": {
 "total": 18,
 "avg": 69.23
 },
 "home": {
 "total": 7,
 "avg": 26.92
 },
 "away": {
 "total": 11,
 "avg": 42.31
 }
 },
 "5.5": {
 "overall": {
 "total": 20,
 "avg": 76.92
 },
 "home": {
 "total": 9,
 "avg": 26.92
 },
 "away": {
 "total": 11,
 "avg": 42.31
 }
 }
 }
 }
 }
 },
...

Test Endpoint

Player Stats / Season

The Player Stats Endpoint gives you singular player statistics by season ID

GETPlayer Statistics by Player ID and Season ID

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringplayer
idinteger{{PLAYER_ID}}
season_idinteger{{SEASON_ID}}

Response

Response Example

                    {
 "data": {
 "id": "13185",
 "name": "Hummels, Mats",
 "matches": {
 "played": {
 "total": 24,
 "avg": 100
 },
 "starting": {
 "total": 24,
 "avg": 100
 }
 },
 "minutes_played": 1998,
 "assists": {
 "total": 4,
 "avg": 16.67
 },
 "penalties": {
 "total": null,
 "avg": 0
 },
 "offsides": {
 "total": 1,
 "avg": 4.17
 },
 "corners": {
 "total": null,
 "avg": 0
 },
 "substitutions": {
 "in": {
 "total": null,
 "avg": 0
 },
 "out": {
 "total": 3,
 "avg": 12.5
 }
 },
 "cards": {
 "yellow": {
 "total": 3,
 "avg": 12.5
 },
 "yellowred": {
 "total": 0,
 "avg": 0
 },
 "redcards": {
 "total": 0,
 "avg": 0
 }
 },
 "goals": {
 "total": 1,
 "avg": 4.17
 },
 "shots": {
 "total": 19,
 "on_target": {
 "total": 5,
 "avg": 26.32
 },
 "off_target": {
 "total": 13,
 "avg": 68.42
 },
 "blocked": {
 "total": 1,
 "avg": 5.26
 }
 }
 },
...

Test Endpoint

Match H2H

The Match H2H Endpoint returns the performance between both teams by Match ID. The Latest 10 matches overall as home and as away and between the both teams.

GETMatch Head to Head

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringmatch
idstring{{MATCH_ID}}

Response

Response Example

                    {
 "data": {
 "home": {
 "id": "111",
 "name": "FC Bayern Munich",
 "events": {
 "overall": [
 {
 "id": "15244112",
 "startdate": "2020-06-16 20:30:00",
 "league": {
 "id": "594",
 "name": "Bundesliga",
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "DEU"
 }
 },
 "teams": {
 "home": {
 "id": "2810",
 "name": "Werder Bremen"
 },
 "away": {
 "id": "111",
 "name": "FC Bayern Munich"
 }
 },
 "ft_score": "0-1",
 "form": "L"
 },
 {
 "id": "15237670",
 "startdate": "2020-06-13 18:30:00",
 "league": {
 "id": "594",
 "name": "Bundesliga",
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "DEU"
 }
 },
 "teams": {
 "home": {
 "id": "111",
 "name": "FC Bayern Munich"
 },
 "away": {
 "id": "2815",
 "name": "Borussia Monchengladbach"
 }
 },
 "ft_score": "2-1",
 "form": "W"
 },
 {
 "id": "15222964",
 "startdate": "2020-06-10 20:45:00",
 "league": {
 "id": "595",
 "name": "DFB Pokal",
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "DEU"
 }
 },
 "teams": {
 "home": {
 "id": "111",
 "name": "FC Bayern Munich"
 },
 "away": {
 "id": "2817",
 "name": "Eintracht Frankfurt"
 }
 },
 "ft_score": "2-1",
 "form": "W"
 },
...

Test Endpoint

H2H Team vs Team

The H2H Team vs Team Endpoint compare the performance between 2 selected teams by ID. The Latest 10 matches overall as home and as away and between both teams.

GETteam vs team Head to Head

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringmatch
team1int{{TEAM1_ID}}
team2int{{TEAM2_ID}}

Response

Response Example

                    {
 "data": {
 "home": {
 "id": "99",
 "name": "FC Barcelona",
 "events": {
 "overall": [
 {
 "id": "31198879",
 "startdate": "2020-06-16 22:00:00",
 "league": {
 "id": "637",
 "name": "LaLiga",
 "country": {
 "id": "5",
 "name": "Spain",
 "cc": "ESP"
 }
 },
 "teams": {
 "home": {
 "id": "99",
 "name": "FC Barcelona"
 },
 "away": {
 "id": "121",
 "name": "CD Leganes"
 }
 },
 "ft_score": "2-0",
 "form": "W"
 },
 {
 "id": "28055364",
 "startdate": "2020-06-13 22:00:00",
 "league": {
 "id": "637",
 "name": "LaLiga",
 "country": {
 "id": "5",
 "name": "Spain",
 "cc": "ESP"
 }
 },
 "teams": {
 "home": {
 "id": "119",
 "name": "RCD Mallorca"
 },
 "away": {
 "id": "99",
 "name": "FC Barcelona"
 }
 },
 "ft_score": "0-4",
 "form": "L"
 },
...

Test Endpoint

Topscorers (Leaders)

The Topscorers Endpoint gives you a list of players leaders in goals, assists and cards by season.

GETTopscorers By Season ID

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringtopscorers
season_idinteger{{SEASON_ID}}

Response

Response Example

                    {
 "data": [
 {
 "pos": 1,
 "player": {
 "id": "1572",
 "name": "Bailey, Leon"
 },
 "team": {
 "id": "114",
 "name": "Leverkusen"
 },
 "league_id": "594",
 "season_id": "406",
 "matches_played": 22,
 "minutes_played": 1094,
 "substituted_in": 10,
 "yellowcards": null,
 "yellowredcards": null,
 "redcards": 2
 },
 {
 "pos": 2,
 "player": {
 "id": "12119",
 "name": "Hubner, Benjamin"
 },
 "team": {
 "id": "2818",
 "name": "Hoffenheim"
 },
 "league_id": "594",
 "season_id": "406",
 "matches_played": 25,
 "minutes_played": 2075,
 "substituted_in": 0,
 "yellowcards": 4,
 "yellowredcards": 1,
 "redcards": 1
 },
 
...

Test Endpoint

Topassists (Leaders)

The Topassists Endpoint gives you a list of players leaders by season.

GETTopassists By Season ID

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringtopassists
season_idinteger{{SEASON_ID}}

Response

Response Example

                    {
 "data": [
 {
 "pos": 1,
 "player": {
 "id": "17327",
 "name": "Muller, Thomas"
 },
 "team": {
 "id": "111",
 "name": "Bayern Munich"
 },
 "league_id": "594",
 "season_id": "406",
 "matches_played": 33,
 "minutes_played": 0,
 "substituted_in": 7,
 "assists": 20
 },
 {
 "pos": 2,
 "player": {
 "id": "6260",
 "name": "Sancho, Jadon"
 },
 "team": {
 "id": "98",
 "name": "Dortmund"
 },
 "league_id": "594",
 "season_id": "406",
 "matches_played": 32,
 "minutes_played": 0,
 "substituted_in": 7,
 "assists": 16
 },

...

Test Endpoint

Topcards (Leaders)

The Topcards Endpoint gives you a list of players leaders in cards by season.

GETTopcards by Season ID

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringtopcards
season_idinteger{{SEASON_ID}}

Response

Response Example

                    {
 "data": [
 {
 "pos": 1,
 "player": {
 "id": "1572",
 "name": "Bailey, Leon"
 },
 "team": {
 "id": "114",
 "name": "Leverkusen"
 },
 "league_id": "594",
 "season_id": "406",
 "minutes_played": 719,
 "yellowcards": null,
 "yellowredcards": null,
 "redcards": 2
 },
 {
 "pos": 2,
 "player": {
 "id": "9101",
 "name": "Schlotterbeck, Keven"
 },
 "team": {
 "id": "2819",
 "name": "Union Berlin"
 },
 "league_id": "594",
 "season_id": "406",
 "minutes_played": 1313,
 "yellowcards": 5,
 "yellowredcards": null,
 "redcards": 1
 },
 {
 "pos": 3,
 "player": {
 "id": "10342",
 "name": "Ehizibue, Kingsley"
 },
 "team": {
 "id": "2809",
 "name": "Cologne"
 },
 "league_id": "594",
 "season_id": "406",
 "minutes_played": 1826,
 "yellowcards": 5,
 "yellowredcards": null,
 "redcards": 1
 },
 {
 "pos": 4,
 "player": {
 "id": "9123",
 "name": "Kohr, Dominik"
 },
 "team": {
 "id": "2817",
 "name": "Frankfurt"
 },
 "league_id": "594",
 "season_id": "406",
 "minutes_played": 906,
 "yellowcards": 5,
 "yellowredcards": null,
 "redcards": 1
 },
 {
 "pos": 5,
 "player": {
 "id": "17324",
 "name": "Boateng, Jerome"
 },
 "team": {
 "id": "111",
 "name": "Bayern Munich"
 },
 "league_id": "594",
 "season_id": "406",
 "minutes_played": 1193,
 "yellowcards": 5,
 "yellowredcards": null,
 "redcards": 1
 },
 {
 "pos": 6,
 "player": {
 "id": "1617",
 "name": "Baku, Ridle"
 },
 "team": {
 "id": "2813",
 "name": "Mainz"
 },
 "league_id": "594",
 "season_id": "406",
 "minutes_played": 1764,
 "yellowcards": 4,
 "yellowredcards": null,
 "redcards": 1
 },
 {
 "pos": 7,
 "player": {
 "id": "10358",
 "name": "Mere, Jorge"
 },
 "team": {
 "id": "2809",
 "name": "Cologne"
 },
 "league_id": "594",
 "season_id": "406",
 "minutes_played": 513,
 "yellowcards": 4,
 "yellowredcards": null,
 "redcards": 1
 },
 {
 "pos": 8,
 "player": {
 "id": "1554",
 "name": "Tah, Jonathan"
 },
 "team": {
 "id": "114",
 "name": "Leverkusen"
 },
 "league_id": "594",
 "season_id": "406",
 "minutes_played": 1763,
 "yellowcards": 4,
 "yellowredcards": null,
 "redcards": 1
 },
 {
 "pos": 9,
 "player": {
 "id": "5624",
 "name": "Abraham, David"
 },
 "team": {
 "id": "2817",
 "name": "Frankfurt"
 },
 "league_id": "594",
 "season_id": "406",
 "minutes_played": 1242,
 "yellowcards": 2,
 "yellowredcards": null,
 "redcards": 1
 },
 {
 "pos": 10,
 "player": {
 "id": "9108",
 "name": "Polter, Sebastian"
 },
 "team": {
 "id": "2819",
 "name": "Union Berlin"
 },
 "league_id": "594",
 "season_id": "406",
 "minutes_played": 308,
 "yellowcards": 1,
 "yellowredcards": null,
 "redcards": 1
 },
 {
 "pos": 11,
 "player": {
 "id": "16616",
 "name": "Pongracic, Marin"
 },
 "team": {
 "id": "2808",
 "name": "Wolfsburg"
 },
 "league_id": "594",
 "season_id": "406",
 "minutes_played": 228,
 "yellowcards": 1,
 "yellowredcards": null,
 "redcards": 1
 },
 {
 "pos": 12,
 "player": {
 "id": "12107",
 "name": "Nubel, Alexander"
 },
 "team": {
 "id": "2816",
 "name": "Schalke"
 },
 "league_id": "594",
 "season_id": "406",
 "minutes_played": 1776,
 "yellowcards": 1,
 "yellowredcards": null,
 "redcards": 1
 },
 {
 "pos": 13,
 "player": {
 "id": "10337",
 "name": "Holtmann, Gerrit"
 },
 "team": {
 "id": "2807",
 "name": "Paderborn"
 },
 "league_id": "594",
 "season_id": "406",
 "minutes_played": 767,
 "yellowcards": 1,
 "yellowredcards": null,
 "redcards": 1
 },
 {
 "pos": 14,
 "player": {
 "id": "12099",
 "name": "Grifo, Vincenzo"
 },
 "team": {
 "id": "2818",
 "name": "Hoffenheim"
 },
 "league_id": "594",
 "season_id": "406",
 "minutes_played": 953,
 "yellowcards": 1,
 "yellowredcards": null,
 "redcards": 1
 },
 {
 "pos": 15,
 "player": {
 "id": "12062",
 "name": "Jarstein, Rune"
 },
 "team": {
 "id": "2806",
 "name": "Hertha"
 },
 "league_id": "594",
 "season_id": "406",
 "minutes_played": 1918,
 "yellowcards": 1,
 "yellowredcards": null,
 "redcards": 1
 },
 {
 "pos": 16,
 "player": {
 "id": "1607",
 "name": "Tisserand, Marcel"
 },
 "team": {
 "id": "2808",
 "name": "Wolfsburg"
 },
 "league_id": "594",
 "season_id": "406",
 "minutes_played": 1204,
 "yellowcards": 6,
 "yellowredcards": 1,
 "redcards": null
 },
 {
 "pos": 17,
 "player": {
 "id": "10327",
 "name": "Collins, Jamilu"
 },
 "team": {
 "id": "2807",
 "name": "Paderborn"
 },
 "league_id": "594",
 "season_id": "406",
 "minutes_played": 1949,
 "yellowcards": 6,
 "yellowredcards": 1,
 "redcards": null
 },
 {
 "pos": 18,
 "player": {
 "id": "14737",
 "name": "Laimer, Konrad"
 },
 "team": {
 "id": "101",
 "name": "Leipzig"
 },
 "league_id": "594",
 "season_id": "406",
 "minutes_played": 1799,
 "yellowcards": 6,
 "yellowredcards": 1,
 "redcards": null
 },
 {
 "pos": 19,
 "player": {
 "id": "12061",
 "name": "Darida, Vladimir"
 },
 "team": {
 "id": "2806",
 "name": "Hertha"
 },
 "league_id": "594",
 "season_id": "406",
 "minutes_played": 1597,
 "yellowcards": 5,
 "yellowredcards": 1,
 "redcards": null
 },
 {
 "pos": 20,
 "player": {
 "id": "6802",
 "name": "Friedrich, Marvin"
 },
 "team": {
 "id": "2819",
 "name": "Union Berlin"
 },
 "league_id": "594",
 "season_id": "406",
 "minutes_played": 2070,
 "yellowcards": 5,
 "yellowredcards": 1,
 "redcards": null
 },
 {
 "pos": 21,
 "player": {
 "id": "1630",
 "name": "Fernandes, Edimilson"
 },
 "team": {
 "id": "2813",
 "name": "Mainz"
 },
 "league_id": "594",
 "season_id": "406",
 "minutes_played": 1267,
 "yellowcards": 4,
 "yellowredcards": 1,
 "redcards": null
 },

...

Test Endpoint

Bookmakers

The Bookmakers Endpoint gives you a list of all Bookmakers available in your plan

GETBookmakers

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringlist

Response

Response Example

                    {
 "data": [
 {
 "id": "1",
 "name": "10Bet",
 "img": "https://cdn.soccersapi.com/images/soccer/bookmakers/1.png"
 },
 {
 "id": "2",
 "name": "bet365",
 "img": "https://cdn.soccersapi.com/images/soccer/bookmakers/2.png"
 },
 {
 "id": "3",
 "name": "188Bet",
 "img": "https://cdn.soccersapi.com/images/soccer/bookmakers/3.png"
 },
 {
 "id": "5",
 "name": "888Sport",
 "img": "https://cdn.soccersapi.com/images/soccer/bookmakers/5.png"
 },
 {
 "id": "6",
 "name": "Bet Fred",
 "img": "https://cdn.soccersapi.com/images/soccer/bookmakers/6.png"
 },
 {
 "id": "7",
 "name": "Bet-At-Home",
 "img": "https://cdn.soccersapi.com/images/soccer/bookmakers/7.png"
 },
 {
 "id": "9",
 "name": "Betfair",
 "img": "https://cdn.soccersapi.com/images/soccer/bookmakers/9.png"
 },
 {
 "id": "14",
 "name": "Dafabet",
 "img": "https://cdn.soccersapi.com/images/soccer/bookmakers/14.png"
 },
 {
 "id": "15",
 "name": "Intertops",
 "img": "https://cdn.soccersapi.com/images/soccer/bookmakers/15.png"
 },
 {
 "id": "16",
 "name": "Marathonbet",
 "img": "https://cdn.soccersapi.com/images/soccer/bookmakers/16.png"
 },
 {
 "id": "20",
 "name": "Pinnacle",
 "img": "https://cdn.soccersapi.com/images/soccer/bookmakers/20.png"
 },
 {
 "id": "23",
 "name": "Unibet",
 "img": "https://cdn.soccersapi.com/images/soccer/bookmakers/23.png"
 },
 {
 "id": "26",
 "name": "Betsson",
 "img": "https://cdn.soccersapi.com/images/soccer/bookmakers/26.png"
 },
 {
 "id": "27",
 "name": "Interwetten",
 "img": "https://cdn.soccersapi.com/images/soccer/bookmakers/27.png"
 },
 {
 "id": "28",
 "name": "BWin",
 "img": "https://cdn.soccersapi.com/images/soccer/bookmakers/28.png"
 },
 {
 "id": "31",
 "name": "TitanBet",
 "img": "https://cdn.soccersapi.com/images/soccer/bookmakers/31.png"
 },
 {
 "id": "32",
 "name": "Ladbrokes",
 "img": "https://cdn.soccersapi.com/images/soccer/bookmakers/32.png"
 },
 {
 "id": "35",
 "name": "1xbet",
 "img": "https://cdn.soccersapi.com/images/soccer/bookmakers/35.png"
 },
 {
 "id": "36",
 "name": "Betway",
 "img": "https://cdn.soccersapi.com/images/soccer/bookmakers/36.png"
 },
 {
 "id": "37",
 "name": "WilliamHill",
 "img": "https://cdn.soccersapi.com/images/soccer/bookmakers/37.png"
 },
 {
 "id": "38",
 "name": "Betclic",
 "img": "https://cdn.soccersapi.com/images/soccer/bookmakers/38.png"
 },
 {
 "id": "39",
 "name": "CloudBet",
 "img": "https://cdn.soccersapi.com/images/soccer/bookmakers/39.png"
 },
 {
 "id": "40",
 "name": "SBOBET",
 "img": "https://cdn.soccersapi.com/images/soccer/bookmakers/40.png"
 }
 ],
...

Test Endpoint

Bookmaker by ID

The Bookmaker by ID Endpoint gives you information of a specific bookmaker by ID

GETBookmaker by ID

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringinfo
idinteger{{BOOKMAKER_ID}}

Response

Response Example

                    {
 "data": {
 "id": "2",
 "name": "bet365",
 "img": "https://cdn.soccersapi.com/images/soccer/bookmakers/2.png"
 },
...

Test Endpoint

Markets

The Markets Endpoint gives a list of all available markets

GETMarkets

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringlist

Response

Response Example

                    {
 "data": [
 {
 "id": "1",
 "name": "1X2, Full Time Result"
 },
 {
 "id": "2",
 "name": "Over/Under, Goal Line"
 },
 {
 "id": "3",
 "name": "Asian Handicap"
 },
 {
 "id": "4",
 "name": "1st Half Asian Handicap"
 },
 {
 "id": "5",
 "name": "Asian Corners"
 },
 {
 "id": "6",
 "name": "1st Half Goal Line"
 },
 {
 "id": "7",
 "name": "1st Half Asian Corners"
 },
 {
 "id": "8",
 "name": "Half Time Result"
 }
 ],
...

Test Endpoint

Market by ID

The Market by ID Endpoint gives you information of a specific market

GETMarket by ID

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringinfo
idinteger{{MARKET_ID}}

Response

Response Example

                    {
 "data": {
 "id": "1",
 "name": "1X2, Full Time Result"
 },
...

Test Endpoint

Pre-Match Odds

The Pre-Match Odds Endpoint gives you Pre-match odds for a specific match

GETPre-Match Odds

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringmatch_odds
idinteger{{MATCH_ID}}

Response

Response Example

                    {
  "data": [
    {
      "id": 1,
      "name": "1X2, Full Time Result",
      "bookmakers": [
        {
          "id": 2,
          "name": "Bet365",
          "odds": {
            "data": {
              "home": "1.440",
              "draw": "4.500",
              "away": "6.500",
              "handicap": null,
              "score": null,
              "minute": null,
              "bookmaker_event_id": null,
              "last_update": {
                "date": "2020-05-07 13:57",
                "timezone": "UTC"
              }
            }
          }
        },
        {
          "id": 1,
          "name": "10Bet",
          "odds": {
            "data": {
              "home": "1.444",
              "draw": "4.650",
              "away": "6.650",
              "handicap": null,
              "score": null,
              "minute": null,
              "bookmaker_event_id": null,
              "last_update": {
                "date": "2020-05-07 13:41",
                "timezone": "UTC"
              }
            }
          }
        },
        {
          "id": 32,
          "name": "Ladbrokes",
          "odds": {
            "data": {
              "home": "1.40",
              "draw": "4.60",
              "away": "7.50",
              "handicap": null,
              "score": null,
              "minute": null,
              "bookmaker_event_id": null,
              "last_update": {
                "date": "2020-05-07 14:40",
                "timezone": "UTC"
              }
            }
          }
        },
        {
          "id": 37,
          "name": "WilliamHill",
          "odds": {
            "data": {
              "home": "1.52",
              "draw": "4.33",
              "away": "6.5",
              "handicap": null,
              "score": null,
              "minute": null,
              "bookmaker_event_id": null,
              "last_update": {
                "date": "2020-05-10 01:05",
                "timezone": "UTC"
              }
            }
          }
        },
        {
          "id": 3,
          "name": "188Bet",
          "odds": {
            "data": {
              "home": "1.49",
              "draw": "4.70",
              "away": "6.00",
              "handicap": null,
              "score": null,
              "minute": null,
              "bookmaker_event_id": null,
              "last_update": {
                "date": "2020-05-07 16:35",
                "timezone": "UTC"
              }
            }
          }
        },
        {
          "id": 23,
          "name": "UniBet",
          "odds": {
            "data": {
              "home": "1.45",
              "draw": "4.55",
              "away": "7.15",
              "handicap": null,
              "score": null,
              "minute": null,
              "bookmaker_event_id": null,
              "last_update": {
                "date": "2020-05-07 13:00",
                "timezone": "UTC"
              }
            }
          }
        },
...

Test Endpoint

In-Play Odds

The In-Play Odds Endpoint gives you Live odds while the match is playing

GETIn-Play Odds by Match ID

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringmatch_oddsinplay
idinteger{{MATCH_ID}}

Response

Response Example

                    {
  "data": [
    {
      "id": 1,
      "name": "1X2, Full Time Result",
      "bookmakers": [
        {
          "id": 2,
          "name": "Bet365",
          "odds": {
            "data": {
              "home": "1.002",
              "draw": "51.000",
              "away": "151.000",
              "handicap": null,
              "score": "3-0",
              "minute": "57",
              "bookmaker_event_id": null,
              "last_update": {
                "date": "2020-05-16 15:46",
                "timezone": "UTC"
              }
            }
          }
        },
        {
          "id": 1,
          "name": "10Bet",
          "odds": {
            "data": {
              "home": "0",
              "draw": "0",
              "away": "0",
              "handicap": null,
              "score": "3:0",
              "minute": "47:49",
              "bookmaker_event_id": null,
              "last_update": {
                "date": "2020-05-16 15:36",
                "timezone": "UTC"
              }
            }
          }
        },
        {
          "id": 32,
          "name": "Ladbrokes",
          "odds": {
            "data": {
              "home": "1.57",
              "draw": "4.20",
              "away": "5.75",
              "handicap": null,
              "score": null,
              "minute": null,
              "bookmaker_event_id": null,
              "last_update": {
                "date": "2020-05-16 14:28",
                "timezone": "UTC"
              }
            }
          }
        },
        {
          "id": 37,
          "name": "WilliamHill",
          "odds": {
            "data": {
              "home": "1.53",
              "draw": "4.33",
              "away": "6",
              "handicap": null,
              "score": null,
              "minute": null,
              "bookmaker_event_id": null,
              "last_update": {
                "date": "2020-05-16 14:38",
                "timezone": "UTC"
              }
            }
          }
        },
        {
          "id": 3,
          "name": "188Bet",
          "odds": {
            "data": {
              "home": "1.02",
              "draw": "21.0",
              "away": "41.0",
              "handicap": null,
              "score": "2-0",
              "minute": "",
              "bookmaker_event_id": null,
              "last_update": {
                "date": "2020-05-16 15:21",
                "timezone": "UTC"
              }
            }
          }
        },
        {
          "id": 23,
          "name": "UniBet",
          "odds": {
            "data": {
              "home": "1",
              "draw": "1001",
              "away": "1",
              "handicap": null,
              "score": "4-0",
              "minute": "72:06",
              "bookmaker_event_id": null,
              "last_update": {
                "date": "2020-05-16 16:01",
                "timezone": "UTC"
              }
            }
          }
        },
        {
          "id": 28,
          "name": "BWin",
          "odds": {
            "data": {
              "home": "1",
              "draw": "1",
              "away": "1",
              "handicap": null,
              "score": "4:0",
              "minute": "90",
              "bookmaker_event_id": null,
              "last_update": {
                "date": "2020-05-16 16:19",
                "timezone": "UTC"
              }
            }
          }
        },
...

Test Endpoint

Match Odds by Bookmaker

The Match Odds by Match ID and Bookmaker ID Endpoint returns all odds for a match in a more detailed way from a single bookmaker.

GETMatch Odds by Bookmaker

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringmatch_odds_info
idinteger{{MATCH_ID}}
bookmaker_idinteger{{BOOKMAKER_ID}}

Response

Response Example

                    {
  "data": {
    "id": "1",
    "name": "10bet",
    "markets": [
      {
        "id": 1,
        "name": "1X2, Full Time Result",
        "odds": [
          {
            "home": "0",
            "draw": "0",
            "away": "0",
            "handicap": null,
            "score": "1:0",
            "minute": "93:38",
            "bookmaker_event_id": null,
            "last_update": {
              "date": "2020-06-05 21:22",
              "timezone": "UTC"
            }
          },
          {
            "home": "1.018",
            "draw": "13.000",
            "away": "48.500",
            "handicap": null,
            "score": "1:0",
            "minute": "93:32",
            "bookmaker_event_id": null,
            "last_update": {
              "date": "2020-06-05 21:22",
              "timezone": "UTC"
            }
          },
          {
            "home": "1.021",
            "draw": "12.500",
            "away": "48.500",
            "handicap": null,
            "score": "1:0",
            "minute": "93:09",
            "bookmaker_event_id": null,
            "last_update": {
              "date": "2020-06-05 21:21",
              "timezone": "UTC"
            }
          },
          {
            "home": "1.005",
            "draw": "17.500",
            "away": "48.500",
            "handicap": null,
            "score": "1:0",
            "minute": "92:52",
            "bookmaker_event_id": null,
            "last_update": {
              "date": "2020-06-05 21:21",
              "timezone": "UTC"
            }
          },
          {
            "home": "1.010",
            "draw": "15.250",
            "away": "48.500",
            "handicap": null,
            "score": "1:0",
            "minute": "92:46",
            "bookmaker_event_id": null,
            "last_update": {
              "date": "2020-06-05 21:21",
              "timezone": "UTC"
            }
          },
          {
            "home": "1.006",
            "draw": "15.750",
            "away": "48.500",
            "handicap": null,
            "score": "1:0",
            "minute": "92:27",
            "bookmaker_event_id": null,
            "last_update": {
              "date": "2020-06-05 21:20",
              "timezone": "UTC"
            }
          },
          {
            "home": "1.010",
            "draw": "15.250",
            "away": "48.500",
            "handicap": null,
            "score": "1:0",
            "minute": "92:21",
            "bookmaker_event_id": null,
            "last_update": {
              "date": "2020-06-05 21:20",
              "timezone": "UTC"
            }
          },
          {
            "home": "1.018",
            "draw": "13.000",
            "away": "48.500",
            "handicap": null,
            "score": "1:0",
            "minute": "91:22",
            "bookmaker_event_id": null,
            "last_update": {
              "date": "2020-06-05 21:19",
              "timezone": "UTC"
            }
          },
          {
            "home": "1.040",
            "draw": "10.000",
            "away": "48.500",
            "handicap": null,
            "score": "1:0",
            "minute": "90:47",
            "bookmaker_event_id": null,
            "last_update": {
              "date": "2020-06-05 21:19",
              "timezone": "UTC"
            }
          },
          {
            "home": "1.036",
            "draw": "10.500",
            "away": "48.500",
            "handicap": null,
            "score": "1:0",
            "minute": "90:29",
            "bookmaker_event_id": null,
            "last_update": {
              "date": "2020-06-05 21:18",
              "timezone": "UTC"
            }
          },
          {
            "home": "1.021",
            "draw": "12.500",
            "away": "48.500",
            "handicap": null,
            "score": "1:0",
            "minute": "90:17",
            "bookmaker_event_id": null,
            "last_update": {
              "date": "2020-06-05 21:18",
              "timezone": "UTC"
            }
          },
          {
            "home": "1.036",
            "draw": "10.500",
            "away": "48.500",
            "handicap": null,
            "score": "1:0",
            "minute": "90:05",
            "bookmaker_event_id": null,
            "last_update": {
              "date": "2020-06-05 21:18",
              "timezone": "UTC"
            }
          },
          {
            "home": "1.030",
            "draw": "11.000",
            "away": "48.500",
            "handicap": null,
            "score": "1:0",
            "minute": "89:59",
            "bookmaker_event_id": null,
            "last_update": {
              "date": "2020-06-05 21:18",
              "timezone": "UTC"
            }
          },
          {
            "home": "1.040",
            "draw": "10.000",
            "away": "48.500",
            "handicap": null,
            "score": "1:0",
            "minute": "89:47",
            "bookmaker_event_id": null,
            "last_update": {
              "date": "2020-06-05 21:18",
              "timezone": "UTC"
            }
},
...

Test Endpoint

Player by ID

The Player by ID endpoint returns information of a single player

GETplayer By ID

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringinfo
idinteger{{PLAYER_ID}}

Response

Response Example

                    {
 "data": {
 "id": "13185",
 "team_id": null,
 "name": "Hummels, Mats Julian",
 "common_name": "Hummels, Mats",
 "position": "D",
 "firstname": "Mats Julian",
 "lastname": "Hummels",
 "birthday": "16/12/88",
 "birthcountry": null,
 "birthplace": null,
 "shirtnumber": "15",
 "weight": "94",
 "height": "191",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/13185.png",
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "de"
 }
 },
...

Test Endpoint

Players by Country

The Players by Country ID Endpoint return all players from a specific country (Nationality)

GETplayer By ID

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringlist
country_idinteger{{COUNTRY_ID}}

Response

Response Example

                    {
 "data": [
 {
 "id": "195",
 "team_id": null,
 "name": "",
 "common_name": "Ristl, Mart",
 "position": "M",
 "firstname": "Mart",
 "lastname": "Ristl",
 "birthday": "07/07/96",
 "birthcountry": null,
 "birthplace": null,
 "shirtnumber": null,
 "weight": "74",
 "height": "178",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/195.png",
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "de"
 }
 },
 {
 "id": "198",
 "team_id": null,
 "name": "",
 "common_name": "Jastrzembski, Dennis",
 "position": "F",
 "firstname": "Dennis",
 "lastname": "Jastrzembski",
 "birthday": "20/02/00",
 "birthcountry": null,
 "birthplace": null,
 "shirtnumber": null,
 "weight": "77",
 "height": "176",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/198.png",
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "de"
 }
 },
 {
 "id": "225",
 "team_id": null,
 "name": "",
 "common_name": "Steinborn, Matthias",
 "position": "F",
 "firstname": "Matthias",
 "lastname": "Steinborn",
 "birthday": "05/03/89",
 "birthcountry": null,
 "birthplace": null,
 "shirtnumber": null,
 "weight": "0",
 "height": "186",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/225.png",
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "de"
 }
 },
 {
 "id": "227",
 "team_id": null,
 "name": "",
 "common_name": "Prokoph, Roman",
 "position": "F",
 "firstname": "Roman",
 "lastname": "Prokoph",
 "birthday": "06/08/85",
 "birthcountry": null,
 "birthplace": null,
 "shirtnumber": null,
 "weight": "76",
 "height": "183",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/227.png",
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "de"
 }
 },
 {
 "id": "275",
 "team_id": null,
 "name": "",
 "common_name": "Gondorf, Jerome",
 "position": "M",
 "firstname": "Jerome",
 "lastname": "Gondorf",
 "birthday": "26/06/88",
 "birthcountry": null,
 "birthplace": null,
 "shirtnumber": null,
 "weight": "76",
 "height": "175",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/275.png",
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "de"
 }
 },
 {
 "id": "277",
 "team_id": null,
 "name": "",
 "common_name": "Fetsch, Mathias",
 "position": "F",
 "firstname": "Mathias",
 "lastname": "Fetsch",
 "birthday": "30/09/88",
 "birthcountry": null,
 "birthplace": null,
 "shirtnumber": null,
 "weight": "85",
 "height": "189",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/277.png",
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "de"
 }
 },
 {
 "id": "316",
 "team_id": null,
 "name": "",
 "common_name": "Fahrmann, Ralf",
 "position": "G",
 "firstname": "Ralf",
 "lastname": "Fahrmann",
 "birthday": "27/09/88",
 "birthcountry": null,
 "birthplace": null,
 "shirtnumber": "21",
 "weight": "95",
 "height": "197",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/316.png",
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "de"
 }
 },
 {
 "id": "317",
 "team_id": null,
 "name": "",
 "common_name": "Stiepermann, Marco",
 "position": "M",
 "firstname": "Marco",
 "lastname": "Stiepermann",
 "birthday": "09/02/91",
 "birthcountry": null,
 "birthplace": null,
 "shirtnumber": "18",
 "weight": "75",
 "height": "190",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/317.png",
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "de"
 }
 },
 {
 "id": "320",
 "team_id": null,
 "name": "",
 "common_name": "Trybull, Tom",
 "position": "M",
 "firstname": "Tom",
 "lastname": "Trybull",
 "birthday": "09/03/93",
 "birthcountry": null,
 "birthplace": null,
 "shirtnumber": "19",
 "weight": "72",
 "height": "181",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/320.png",
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "de"
 }
 },
 {
 "id": "476",
 "team_id": null,
 "name": "",
 "common_name": "Rupp, Lukas",
 "position": "M",
 "firstname": "Lukas",
 "lastname": "Rupp",
 "birthday": "08/01/91",
 "birthcountry": null,
 "birthplace": null,
 "shirtnumber": "7",
 "weight": "73",
 "height": "178",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/476.png",
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "de"
 }
 },
 {
 "id": "480",
 "team_id": null,
 "name": "",
 "common_name": "Leno, Bernd",
 "position": "G",
 "firstname": "Bernd",
 "lastname": "Leno",
 "birthday": "04/03/92",
 "birthcountry": null,
 "birthplace": null,
 "shirtnumber": "1",
 "weight": "83",
 "height": "190",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/480.png",
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "de"
 }
 },
 {
 "id": "482",
 "team_id": null,
 "name": "",
 "common_name": "Mustafi, Shkodran",
 "position": "D",
 "firstname": "Shkodran",
 "lastname": "Mustafi",
 "birthday": "17/04/92",
 "birthcountry": null,
 "birthplace": null,
 "shirtnumber": "20",
 "weight": "82",
 "height": "184",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/482.png",
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "de"
 }
 },
 {
 "id": "488",
 "team_id": null,
 "name": "",
 "common_name": "Ozil, Mesut",
 "position": "M",
 "firstname": "Mesut",
 "lastname": "Ozil",
 "birthday": "15/10/88",
 "birthcountry": null,
 "birthplace": null,
 "shirtnumber": "10",
 "weight": "70",
 "height": "180",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/488.png",
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "de"
 }
 },
 {
 "id": "679",
 "team_id": null,
 "name": "",
 "common_name": "Kehrer, Thilo",
 "position": "D",
 "firstname": "Thilo",
 "lastname": "Kehrer",
 "birthday": "21/09/96",
 "birthcountry": null,
 "birthplace": null,
 "shirtnumber": "4",
 "weight": "76",
 "height": "186",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/679.png",
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "de"
 }
 },
 {
 "id": "693",
 "team_id": null,
 "name": "",
 "common_name": "Draxler, Julian",
 "position": "M",
 "firstname": "Julian",
 "lastname": "Draxler",
 "birthday": "20/09/93",
 "birthcountry": null,
 "birthplace": null,
 "shirtnumber": "23",
 "weight": "74",
 "height": "185",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/693.png",
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "de"
 }
 },
 {
 "id": "918",
 "team_id": null,
 "name": "Buyuksakarya, Marvin Sinan",
 "common_name": "Buyuksakarya, Marvin",
 "position": "D",
 "firstname": "Marvin Sinan",
 "lastname": "Buyuksakarya",
 "birthday": "11/04/95",
 "birthcountry": null,
 "birthplace": null,
 "shirtnumber": "14",
 "weight": "68",
 "height": "173",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/918.png",
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "de"
 }
 },
 {
 "id": "934",
 "team_id": null,
 "name": "",
 "common_name": "Sen, Utku",
 "position": "F",
 "firstname": "Utku",
 "lastname": "Sen",
 "birthday": "15/06/98",
 "birthcountry": null,
 "birthplace": null,
 "shirtnumber": "11",
 "weight": "83",
 "height": "178",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/934.png",
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "de"
 }
 },
 {
 "id": "1335",
 "team_id": null,
 "name": "",
 "common_name": "Niepsuj, David",
 "position": "D",
 "firstname": "David",
 "lastname": "Niepsuj",
 "birthday": "16/08/95",
 "birthcountry": null,
 "birthplace": null,
 "shirtnumber": "19",
 "weight": "76",
 "height": "182",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/1335.png",
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "de"
 }
 },
 {
 "id": "1408",
 "team_id": null,
 "name": "",
 "common_name": "Dahne, Thomas",
 "position": "G",
 "firstname": "Thomas",
 "lastname": "Dahne",
 "birthday": "04/01/94",
 "birthcountry": null,
 "birthplace": null,
 "shirtnumber": "30",
 "weight": "84",
 "height": "193",
 "img": "https://cdn.soccersapi.com/images/soccer/players/50/1408.png",
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "de"
 }
 },
...

Test Endpoint

Scheduled on TV by Date

The Scheduled on TV by Date Endpoint gives you a list of matches that will be or has been broadcasted on TV or Streaming. Note that to know related TV Channels you must to retrieve "Match TV Channels" for each respective Match ID.

GETScheduled on TV by Date

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringmatch_tvs
dstring{{YYYY-MM-DD}}

Response

Response Example

                    {
  "data": [
    {
      "id": 1275651,
      "status": "3",
      "status_name": "Finished",
      "status_period": null,
      "pitch": null,
      "referee_id": "1305",
      "round_id": "32697",
      "round_name": "1",
      "season_id": "7070",
      "season_name": "20/21",
      "stage_id": "1",
      "stage_name": "Regular Season",
      "group_id": null,
      "group_name": null,
      "aggregate_id": null,
      "winner_team_id": "2223",
      "venue_id": "2551",
      "leg": null,
      "week": "40",
      "deleted": "0",
      "time": {
        "datetime": "2020-10-01 00:30:00",
        "date": "2020-10-01",
        "time": "00:30:00",
        "minute": null,
        "timestamp": 1601505000,
        "timezone": "UTC"
      },
      "teams": {
        "home": {
          "id": 869,
          "name": "Botafogo FR RJ",
          "short_code": "BOT",
          "img": "https://cdn.soccersapi.com/images/soccer/teams/80/869.png",
          "form": "3-4-3",
          "coach_id": "5173",
          "kit_colors": {
            "home_main_color": "#000000",
            "home_second_color": "#000000",
            "home_number_color": "#ffffff",
            "home_gk_main_color": "#9999cc",
            "home_gk_second_color": "#9999cc",
            "home_gk_number_color": "#ffffff"
          }
        },
        "away": {
          "id": 2223,
          "name": "EC Bahia BA",
          "short_code": "BAH",
          "img": "https://cdn.soccersapi.com/images/soccer/teams/80/2223.png",
          "form": "4-4-2",
          "coach_id": "6176",
          "kit_colors": {
            "away_main_color": "#ffffff",
            "away_second_color": "#0033ff",
            "away_number_color": "#0400ff",
            "away_gk_main_color": "#ff0000",
            "away_gk_second_color": "#ff0000",
            "away_gk_number_color": "#000000"
          }
        }
      },
      "league": {
        "id": 1358,
        "name": "Brasileiro Serie A",
        "type": "",
        "country_id": "25",
        "country_name": "Brazil",
        "country_flag": "https://cdn.soccersapi.com/images/countries/30/br.png"
      },
      "scores": {
        "home_score": "1",
        "away_score": "2",
        "ht_score": "0-1",
        "ft_score": "1-2",
        "et_score": null,
        "ps_score": null
      },
      "standings": {
        "home_position": 18,
        "away_position": 20
      },
      "assistants": {
        "first_assistant_id": null,
        "second_assistant_id": null,
        "fourth_assistant_id": null
      },
      "coverage": {
        "has_lineups": 1,
        "has_tvs": 1,
        "has_standings": 1
      },
      "weather_report": {
        "desc": "clear/sunny",
        "temp": {
          "celsius": 29,
          "fahrenheit": 84.2
        },
        "wind": {
          "kmph": 5,
          "miles": 3.1,
          "direction": "S"
        },
        "humidity_percent": 80,
        "pressure": 1013
      }
    },
    {
      "id": 1275652,
      "status": "3",
      "status_name": "Finished",
      "status_period": null,
      "pitch": null,
      "referee_id": "1306",
      "round_id": "32697",
      "round_name": "1",
      "season_id": "7070",
      "season_name": "20/21",
      "stage_id": "1",
      "stage_name": "Regular Season",
      "group_id": null,
      "group_name": null,
      "aggregate_id": null,
      "winner_team_id": null,
      "venue_id": "58",
      "leg": null,
      "week": "40",
      "deleted": "0",
      "time": {
        "datetime": "2020-10-01 00:30:00",
        "date": "2020-10-01",
        "time": "00:30:00",
        "minute": null,
        "timestamp": 1601505000,
        "timezone": "UTC"
      },
      "teams": {
        "home": {
          "id": 2224,
          "name": "SC Corinthians SP",
          "short_code": "COR",
          "img": "https://cdn.soccersapi.com/images/soccer/teams/80/2224.png",
          "form": "4-2-3-1",
          "coach_id": "3016",
          "kit_colors": {
            "home_main_color": "#ffffff",
            "home_second_color": "#ffffff",
            "home_number_color": "#000000",
            "home_gk_main_color": "#ffcc00",
            "home_gk_second_color": "#000000",
            "home_gk_number_color": "#000000"
          }
        },
        "away": {
          "id": 3519,
          "name": "AC Goianiense GO",
          "short_code": "GOI",
          "img": "https://cdn.soccersapi.com/images/soccer/teams/80/3519.png",
          "form": "4-2-3-1",
          "coach_id": "3023",
          "kit_colors": {
            "away_main_color": "#000000",
            "away_second_color": "#ff0000",
            "away_number_color": "#ffffff",
            "away_gk_main_color": "#ffff00",
            "away_gk_second_color": "#ffff00",
            "away_gk_number_color": "#000000"
          }
        }
      },
      "league": {
        "id": 1358,
        "name": "Brasileiro Serie A",
        "type": "",
        "country_id": "25",
        "country_name": "Brazil",
        "country_flag": "https://cdn.soccersapi.com/images/countries/30/br.png"
      },
      "scores": {
        "home_score": "0",
        "away_score": "0",
        "ht_score": "0-0",
        "ft_score": "0-0",
        "et_score": null,
        "ps_score": null
      },
      "standings": {
        "home_position": 15,
        "away_position": 13
      },
      "assistants": {
        "first_assistant_id": null,
        "second_assistant_id": null,
        "fourth_assistant_id": null
      },
      "coverage": {
        "has_lineups": 1,
        "has_tvs": 1,
        "has_standings": 1
      },
      "weather_report": {
        "desc": "clear/sunny",
        "temp": {
          "celsius": 30,
          "fahrenheit": 86
        },
        "wind": {
          "kmph": 11,
          "miles": 6.82,
          "direction": "ENE"
        },
        "humidity_percent": 34,
        "pressure": 1015
      }
    },
...

Test Endpoint

Match TV Channels

The Match TV Channels Endpoint returns International TV Channels that will cover the specified match.

GETTV Channels by Match ID

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringmatch_tvs
idinteger{{MATCH_ID}}

Response

Response Example

                    {
 "data": [
 {
 "id": "676",
 "name": "Eurosport 2 Bulgaria",
 "country": {
 "id": "8",
 "name": "Albania",
 "cc": "al"
 }
 },
 {
 "id": "513",
 "name": "beIN Sports HD 1",
 "country": {
 "id": "9",
 "name": "Algeria",
 "cc": "dz"
 }
 },
 {
 "id": "1381",
 "name": "beIN Sports HD 11",
 "country": {
 "id": "9",
 "name": "Algeria",
 "cc": "dz"
 }
 },
 {
 "id": "55",
 "name": "beIN SPORTS CONNECT",
 "country": {
 "id": "9",
 "name": "Algeria",
 "cc": "dz"
 }
 },
 {
 "id": "222",
 "name": "ESPNPlay Caribbean",
 "country": {
 "id": null,
 "name": "Anguilla",
 "cc": null
 }
 },
 {
 "id": "224",
 "name": "ESPN Caribbean",
 "country": {
 "id": null,
 "name": "Anguilla",
 "cc": null
 }
 },
 {
 "id": "225",
 "name": "ESPNPlay Caribbean",
 "country": {
 "id": null,
 "name": "Antigua and Barbuda",
 "cc": null
 }
 },
 {
 "id": "227",
 "name": "ESPN Caribbean",
 "country": {
 "id": null,
 "name": "Antigua and Barbuda",
 "cc": null
 }
 },
 {
 "id": "347",
 "name": "ESPN2 Sur",
 "country": {
 "id": "12",
 "name": "Argentina",
 "cc": "ar"
 }
 },
 {
 "id": "62",
 "name": "ESPN Play Sur",
 "country": {
 "id": "12",
 "name": "Argentina",
 "cc": "ar"
 }
 },
 {
 "id": "1548",
 "name": "Setanta Sports 2",
 "country": {
 "id": "13",
 "name": "Armenia",
 "cc": "am"
 }
 },
 {
 "id": "231",
 "name": "ESPNPlay Caribbean",
 "country": {
 "id": null,
 "name": "Aruba",
 "cc": null
 }
 },
 {
 "id": "230",
 "name": "ESPN Caribbean",
 "country": {
 "id": null,
 "name": "Aruba",
 "cc": null
 }
 },
 {
 "id": "234",
 "name": "Kayo Sports",
 "country": {
 "id": "14",
 "name": "Australia",
 "cc": "au"
 }
 },
 {
 "id": "232",
 "name": "beIN Sports Connect",
 "country": {
 "id": "14",
 "name": "Australia",
 "cc": "au"
 }
 },
 {
 "id": "233",
 "name": "beIN Sports 1",
 "country": {
 "id": "14",
 "name": "Australia",
 "cc": "au"
 }
 },
 {
 "id": "32",
 "name": "Sky Sport Bundesliga 1",
 "country": {
 "id": "15",
 "name": "Austria",
 "cc": "at"
 }
 },
 {
 "id": "31",
 "name": "Sky Go",
 "country": {
 "id": "15",
 "name": "Austria",
 "cc": "at"
 }
 },
 {
 "id": "813",
 "name": "Sky Sport Bundesliga 2",
 "country": {
 "id": "15",
 "name": "Austria",
 "cc": "at"
 }
 },
 {
 "id": "1549",
 "name": "Setanta Sports 2",
 "country": {
 "id": "17",
 "name": "Azerbaijan",
 "cc": "az"
 }
 },
 {
 "id": "237",
 "name": "ESPN Caribbean",
 "country": {
 "id": null,
 "name": "Bahamas",
 "cc": null
 }
 },
 {
 "id": "1382",
 "name": "beIN Sports HD 11",
 "country": {
 "id": "18",
 "name": "Bahrain",
 "cc": "bh"
 }
 },
 {
 "id": "514",
 "name": "beIN Sports HD 1",
 "country": {
 "id": "18",
 "name": "Bahrain",
 "cc": "bh"
 }
 },
 {
 "id": "68",
 "name": "beIN SPORTS CONNECT",
 "country": {
 "id": "18",
 "name": "Bahrain",
 "cc": "bh"
 }
 },
 {
 "id": "69",
 "name": "Star Sports Select HD1",
 "country": {
 "id": "19",
 "name": "Bangladesh",
 "cc": "bd"
 }
 },
 {
 "id": "242",
 "name": "ESPN Caribbean",
 "country": {
 "id": null,
 "name": "Barbados",
 "cc": null
 }
 },
 {
 "id": "240",
 "name": "ESPNPlay Caribbean",
 "country": {
 "id": null,
 "name": "Barbados",
 "cc": null
 }
 },
 {
 "id": "1550",
 "name": "Setanta Sports 2",
 "country": {
 "id": "20",
 "name": "Belarus",
 "cc": "by"
 }
 },
...

Test Endpoint

Coach by ID

The Coach by ID Endpoint give you information of a specific coach

GETcoaches By ID

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringinfo
idinteger{{COACH_ID}}

Response

Response Example

                    {
 "data": {
 "id": "1007",
 "team_id": null,
 "name": null,
 "common_name": "Favre, Lucien",
 "firstname": "Lucien",
 "lastname": "Favre",
 "birthday": "02/11/57",
 "birthcountry": null,
 "birthplace": null,
 "img": "https://cdn.soccersapi.com/images/soccer/coaches/50/1007.png",
 "country": {
 "id": "114",
 "name": "Switzerland",
 "cc": "ch"
 }
 },
...

Test Endpoint

Venue by ID

The Venue by ID Endpoint give you information of a specific venue

GETVenue By ID

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringinfo
idinteger{{VENUE_ID}}

Response

Response Example

                    {
 "data": {
 "id": "1216",
 "name": "Signal Iduna Park",
 "capacity": "81365",
 "city": "Dortmund",
 "address": "",
 "img": "https://cdn.soccersapi.com/images/soccer/venues/1216.jpg",
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "de"
 }
 },
...

Test Endpoint

Referee by ID

The Referee by ID Endpoint give you information of a specific Referee

GETReferee By ID

API Reference

URI Parameters

userString{{USERNAME}}
tokenstring{{TOKEN}}
tstringinfo
idinteger{{REFEREE_ID}}

Response

Response Example

                    {
 "data": {
 "id": "372",
 "name": "",
 "common_name": "Aytekin, Deniz",
 "firstname": "Deniz",
 "lastname": "Aytekin", 
 "birthdate": "21/07/78",
 "img": "https://cdn.soccersapi.com/images/soccer/referees/50/372.png",
 "country": {
 "id": "4",
 "name": "Germany",
 "cc": "de"
 }
 },

...

Test Endpoint