Documentation v2.2

SoccersAPI / Documentation Version 2.2

Introduction

  • API : Soccers' API
  • API Version : v 2.2
  • API Contents : Football

SoccersAPI is a RESTful service for soccer data sport. It is a PAID service with low price (started with $25 per month). Note that in order to access Soccer's API you must purchase related packages. Please contact us if you have any problem.

Setup the API

  1. After subscribe, login and go to https://soccersapi.com/dashboard/api-key
  2. Generate a TOKEN in your user Dashboard
  3. Take your USERNAME and your TOKEN
  4. Now you're ready to make calls to the API
Note that some endpoints aren't available while trial period.

Authentication #back to top

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=YOUR_USER&token=YOUR_TOKEN&t=list
Make sure replace YOUR_USER and YOUR_TOKEN values with yours.

Statuses and Explanation#back to top

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.

Images #back to top

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 
50x50
 https://cdn.soccersapi.com/images/soccer/leagues/50/1005.png 
80x80
 https://cdn.soccersapi.com/images/soccer/leagues/80/1005.png 
100x100
 https://cdn.soccersapi.com/images/soccer/leagues/100/1005.png 

Teams

18x18
 https://cdn.soccersapi.com/images/soccer/teams/18/104.png 
50x50
 https://cdn.soccersapi.com/images/soccer/teams/50/104.png 
80x80
 https://cdn.soccersapi.com/images/soccer/teams/80/104.png 
100x100
 https://cdn.soccersapi.com/images/soccer/teams/100/104.png 

Players

18x18
 https://cdn.soccersapi.com/images/soccer/players/18/1000.png 
50x50
 https://cdn.soccersapi.com/images/soccer/players/50/1000.png 
80x80
 https://cdn.soccersapi.com/images/soccer/players/80/1000.png 
100x100
 https://cdn.soccersapi.com/images/soccer/players/150/1000.png 

Bookmakers (1 size)

80x
 https://cdn.soccersapi.com/images/soccer/bookmakers/2.png 

Changelog #back to top

Soccer's API Version 2.2

All Continents#back to top

The Continents endpoint gives you a list of all Continents.

GET Get All Continents

URI Parameters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringlist

Response Attributes

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"
        }
    ],
...
            
 

Continent by ID#back to top

The Get Continent By Id Endpoint gives you data from a specific continent.

GET Get Continent By Id

API Reference

URI Parameters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringinfo
idstringCONTINENT_ID

Response Example

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

All Countries#back to top

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

GET Get All Countries

URI Parameters

user string YOUR_USER
token string YOUR_TOKEN
t string list
page integer PAGE_NUMBER

Response Attributes

id integer The id of the country
name string The name of the country
continent string The continent of the country
sub_region string Region of the country
code string Code of 2 letters of country

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"
        },
...

Country by ID#back to top

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

GET Get Country By Id

API Reference
https://api.soccersapi.com/v2.2/countries/(?user, token, t, id)

URI Parameters

user string YOUR_USER
token string YOUR_TOKEN
t string info
id integer COUNTRY_ID

Response Attributes

id integer The id of the country
name string The name of the country
continent string The continent of the country
sub_region string Region of the country
long string Longitude
lat string Latitude
code string Code of 2 letters of country

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"
    },
...

All Leagues#back to top

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

GET Get All Leagues

URI Parameters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringlist
pageintegerPAGE_NUMBER

Response Attributes

idintegerThe id of the league
namestringThe name of the league
is_cupstringBoolean if that league is cup
is_amateurstringBoolean if that league is amateur
country_idintegerCOUNTRY_ID
continent_idintegerCONTINENT_ID

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
        },
...

All Leagues by Country ID#back to top

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

GET Get All Leagues by country ID

URI Parameters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringlist
country_idintegerCOUNTRY_ID

Response Attributes

idintegerThe id of the league
namestringThe name of the league
is_amateurintegerBoolean if the league is amateur
id_current_seasonintegerThe id of the current season
id_current_stageintegerThe id of the current stage
id_current_roundintegerThe id of the current round
continentobjectid, name
countryobjectid, name, cc
seasonsobjectid, name, is_current

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"
                }
            ]
        },
...

League by ID #back to top

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

GET Get League by ID

API Reference

URI Parameters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringinfo
idintegerLEAGUE_ID

Response Attributes

idintegerThe id of the league
namestringThe name of the league
is_cupstringBoolean if that league is cup
id_current_seasonstringCurrent Season
id_current_stagestringCurrent Stage
id_current_roundstringCurrent Round
continentobjectid, name
seasonsobjectid, name, is_current

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"
            }
        ]
    },
...

League Standings #back to top

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.

GET Get League Standings by Season ID

API Reference

URI Parameters

user string YOUR_USER
token string YOUR_TOKEN
t string standings
season_id integer SEASON_ID

Response Attributes

league_idintegerThe id of the season
season_idstringThe name of the league
stage_idstringBoolean if that league is cup
round_idstringCurrent Season
standingsobjectposition, team_id, team_name, round, group, status, result, points, recent_form
overallobjectgames_played, won, draw, lost, goals_diff, goals_scored, goals_against, points, position
homeobjectgames_played, won, draw, lost, goals_diff, goals_scored, goals_against, points, position
awayobjectgames_played, won, draw, lost, goals_diff, goals_scored, goals_against, points, position

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
                },
...

Season by ID#back to top

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

GET Get Season By ID

API Reference

URI Parameters

user string YOUR_USER
token string YOUR_TOKEN
t string info
id integer SEASON_ID

Response Attributes

id integer The id of the season
name string The name of the season
is_current boolean Boolean if the Season is current
league_id integer The id of the league associated
current_round_id integer The id of the current round
rounds object id
current_stage_id integer The id of the current stage

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
    },
...

Stage by ID (Available soon) #back to top

The Stage by ID Endpoint gives you info about a specific Stage, like their league, season, name, rounds.

GET Get Stage By ID

API Reference

URI Params

Name Type Value
user string YOUR_USER
token string YOUR_TOKEN
t string info
id integer STAGE_ID

Response Attributes

id integer The id of the stage
name string The name of the stage
league_id integer The id of the league of the stage
season_id integer The id of the season of the stage
rounds object id, stage_id
groups object id, stage_id

Response Example

{
   "data":{
      "id":77444636,
      "name":"Group Stage",
      "league_id":1497,
      "season_id":15720,
      "rounds":[
         {
            "id":null,
            "stage_id":77444636
         },
         {
            "id":null,
            "stage_id":77444636
         },
         {
            "id":null,
            "stage_id":77444636
         }
      ],
      "groups":[
         {
            "id":243491,
            "stage_id":77444636
         },
         {
            "id":243492,
            "stage_id":77444636
         },
         {
            "id":243493,
            "stage_id":77444636
         },
         {
            "id":243494,
            "stage_id":77444636
         }
      ]
   }
}

Rounds by Season #back to top

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

GETGet Rounds by Season ID

API Reference
userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringbyseason
season_idintegerSEASON_ID
idintegerThe id of the round
namestringThe name of the round
league_idintegerThe league id of the round
season_idintegerThe season id of the round
is_currentbooleanIf is the current season
{
    "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
        },
...
        

Round by ID#back to top

The Round by ID endpoint returns information of a single round

GET Get Round By ID

API Reference

URI Parameters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringinfo
idintegerROUND_ID

Response

idintegerThe id of the round
namestringThe name of the round
league_idintegerThe league id of the round
season_idintegerThe season id of the round
{
    "data": {
        "id": "2005",
        "name": "12",
        "league_id": "594",
        "season_id": "406",
        "is_current": null
    },
...

Teams by Country #back to top

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

GETGet Teams by Country ID

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringlist
country_idintegerCOUNTRY_ID
idintegerThe ID of the team
common_namestringThe common name of the team
namestringThe name of the team
short_codestringShort code of the team
imgstringLogo of the team
leaguesobjectID, name, current_season
foundedstringYear of Foundation
twitterstringTwitter account
coach_idintegerThe ID of the current coach
venue_idintegervenue ID
countryobjectID, name, cc
{
    "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"
        },
...

Teams by Season #back to top

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

GETGet Teams by Season ID

API Reference
userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringbyseason
season_idintegerSEASON_ID
idintegerThe id of the team
namestringThe name of the team
country_idintegerid of the country
{
    "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"
        },
...
        

Team by ID #back to top

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

GET Get Team By Id

API Reference

URI Parameters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringinfo
idintegerTEAM_ID

Response Attributes

idintegerThe ID of the team
common_namestringThe common name of the team
namestringThe name of the team
short_codestringShort code of the team
imgstringLogo of the team
leaguesobjectID, name, current_season
foundedstringYear of Foundation
twitterstringTwitter account
coach_idintegerThe ID of the current coach
venue_idintegervenue ID
countryobjectID, name, cc

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": "539",
                "name": "UEFA Champions League",
                "current_season_id": "45"
            },
            {
                "id": "594",
                "name": "Bundesliga",
                "current_season_id": "406"
            },
            {
                "id": "595",
                "name": "DFB Pokal",
                "current_season_id": "1909"
            },
            {
                "id": "539",
                "name": "UEFA Champions League",
                "current_season_id": "45"
            },
            {
                "id": "3700",
                "name": "MLS All Star Game",
                "current_season_id": "9683"
            },
            {
                "id": "596",
                "name": "Super Cup",
                "current_season_id": "8387"
            },
            {
                "id": "515",
                "name": "Audi Cup",
                "current_season_id": "8694"
            }
        ],
        "founded": "1900",
        "twitter": "",
        "coach_id": "662",
        "venue_id": "1446",
        "country": {
            "id": "4",
            "name": "Germany",
            "cc": "de"
        }
    },
...

Team Squad#back to top

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

GET Get Squad By Team Id and Season ID

API Reference

URI Parameters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringsquad
idintegerTEAM_ID
season_idintegerSEASON_ID

Response Attributes

formationstringThe standard team formation
squadobjectplayer
playerobjectID, name, common_name, firstname, lastname, weight, height, img, country
countryobjectID, name, cc
numberstringThe number of the player
captainbooleanIf is captain
positionstringThe player field position
orderstringThe player order in formation
{
    "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
            },
...
 

Team Squad current season#back to top

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

GET Get Squad By Team Id

API Reference

URI Parameters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringsquad
idintegerTEAM_ID

Response Attributes

formationstringThe standard team formation
squadobjectplayer
playerobjectID, name, common_name, firstname, lastname, weight, height, img, country
countryobjectID, name, cc
numberstringThe number of the player
captainbooleanIf is captain
positionstringThe player field position
orderstringThe player order in formation
{
    "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
            },
...
 

Team Transfers#back to top

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

GETGet Transfers By Team Id

API Reference
userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringtransfers
idintegerTEAM_ID
season_idintegerSEASON_ID
player_idintegerThe id of the player
from_team_idstringThe team where it comes from
to_team_idstringThe team where it comes from
id_current_seasonstringCurrent Season
id_current_stagestringCurrent Stage
id_current_roundstringCurrent Round
oundobjectid, name, cc
seasonsobjectid, name, is_current
{
    "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"
            },
 
...
        

Team Sidelined#back to top

The Team Sidelined endpoint return data about injuried players.

GETGet Sidelined By Team Id

API Reference
userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringsidelined
idintegerTEAM_ID
{
    "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"
                }
            ]
        }
    },
...

Team Trophies#back to top

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

GETGet Trophies By Team Id

API Reference
userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringtrophies
idintegerTEAM_ID
{
    "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",
...

Livescores Today#back to top

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

GETGet Today Matches

API Reference

URI Parameters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringtoday

Response

idintegerThe id for this match
statusintegerThe status for this match
pitchstringPith of event
referee_idreferee_idReferee's id
round_idintegerId of round for this match (if have)
season_idintegerId of season for this match
stage_idintegerPith of event
group_idintegerId of the group for Cups
aggregate_idaggregate_idAggregate id
winner_team_idintegerSometimes this parameter is needed
venue_idintegerVenue id
legstringExample 1/1
deletedbooleanIf there's a mistake in this event, response will be true
timeobjectdatetime, date, time, minute(playing), timestamp, timezone
teamsobjecthome(id,name,short_code,img,form,coach_id,color,kit_colors), away(id,name,short_code,img,form,coach_id,color,kit_colors)
leagueobjectid, name, type, country_id, country_name, country_flag
scoresobjecthome_score, away_score, ht_score, ft_score, et_score, ps_score
standingsobjecthome_position, away_position
assistantsobjectfirst_assistant_id, second_assistant_id, fourth_assistant_id
weather_reportobjectWeather report if exist (code,type,temperature in fahrenheit or celcius, clouds,humidity,pressure,wind,...)

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
        },
 ...

Livescores Tomorrow#back to top

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

GETGet Tomorrow Matches

API Reference

URI Parameters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringtomorrow

Response

idintegerThe id for this match
statusintegerThe status for this match
pitchstringPith of event
referee_idreferee_idReferee's id
round_idintegerId of round for this match (if have)
season_idintegerId of season for this match
stage_idintegerPith of event
group_idintegerId of the group for Cups
aggregate_idaggregate_idAggregate id
winner_team_idintegerSometimes this parameter is needed
venue_idintegerVenue id
legstringExample 1/1
deletedbooleanIf there's a mistake in this event, response will be true
timeobjectdatetime, date, time, minute(playing), timestamp, timezone
teamsobjecthome(id,name,short_code,img,form,coach_id,color,kit_colors), away(id,name,short_code,img,form,coach_id,color,kit_colors)
leagueobjectid, name, type, country_id, country_name, country_flag
scoresobjecthome_score, away_score, ht_score, ft_score, et_score, ps_score
standingsobjecthome_position, away_position
assistantsobjectfirst_assistant_id, second_assistant_id, fourth_assistant_id
weather_reportobjectWeather report if exist (code,type,temperature in fahrenheit or celcius, clouds,humidity,pressure,wind,...)

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
        },
...

Livescores Yesterday#back to top

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

GETGet yesterday Matches

API Reference

URI Parameters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringyesterday

Response

idintegerThe id for this match
statusintegerThe status for this match
pitchstringPith of event
referee_idreferee_idReferee's id
round_idintegerId of round for this match (if have)
season_idintegerId of season for this match
stage_idintegerPith of event
group_idintegerId of the group for Cups
aggregate_idaggregate_idAggregate id
winner_team_idintegerSometimes this parameter is needed
venue_idintegerVenue id
legstringExample 1/1
deletedbooleanIf there's a mistake in this event, response will be true
timeobjectdatetime, date, time, minute(playing), timestamp, timezone
teamsobjecthome(id,name,short_code,img,form,coach_id,color,kit_colors), away(id,name,short_code,img,form,coach_id,color,kit_colors)
leagueobjectid, name, type, country_id, country_name, country_flag
scoresobjecthome_score, away_score, ht_score, ft_score, et_score, ps_score
standingsobjecthome_position, away_position
assistantsobjectfirst_assistant_id, second_assistant_id, fourth_assistant_id
weather_reportobjectWeather report if exist (code,type,temperature in fahrenheit or celcius, clouds,humidity,pressure,wind,...)

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
        },
...

Livescores Inplay#back to top

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

GETGet Inplay Matches

API Reference

URI Paramters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringlive

Response

idintegerThe id for this match
statusintegerThe status for this match
pitchstringPith of event
referee_idreferee_idReferee's id
round_idintegerId of round for this match (if have)
season_idintegerId of season for this match
stage_idintegerPith of event
group_idintegerId of the group for Cups
aggregate_idaggregate_idAggregate id
winner_team_idintegerSometimes this parameter is needed
venue_idintegerVenue id
legstringExample 1/1
deletedbooleanIf there's a mistake in this event, response will be true
timeobjectdatetime, date, time, minute(playing), timestamp, timezone
teamsobjecthome(id,name,short_code,img,form,coach_id,color,kit_colors), away(id,name,short_code,img,form,coach_id,color,kit_colors)
leagueobjectid, name, type, country_id, country_name, country_flag
scoresobjecthome_score, away_score, ht_score, ft_score, et_score, ps_score
standingsobjecthome_position, away_position
assistantsobjectfirst_assistant_id, second_assistant_id, fourth_assistant_id
weather_reportobjectWeather report if exist (code,type,temperature in fahrenheit or celcius, clouds,humidity,pressure,wind,...)

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
        }
    ],
...
    

Livescores Not Started#back to top

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

GETGet Not Started Matches

API Reference

URI Paramters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringnotstarted

Response

idintegerThe id for this match
statusintegerThe status for this match
pitchstringPith of event
referee_idreferee_idReferee's id
round_idintegerId of round for this match (if have)
season_idintegerId of season for this match
stage_idintegerPith of event
group_idintegerId of the group for Cups
aggregate_idaggregate_idAggregate id
winner_team_idintegerSometimes this parameter is needed
venue_idintegerVenue id
legstringExample 1/1
deletedbooleanIf there's a mistake in this event, response will be true
timeobjectdatetime, date, time, minute(playing), timestamp, timezone
teamsobjecthome(id,name,short_code,img,form,coach_id,color,kit_colors), away(id,name,short_code,img,form,coach_id,color,kit_colors)
leagueobjectid, name, type, country_id, country_name, country_flag
scoresobjecthome_score, away_score, ht_score, ft_score, et_score, ps_score
standingsobjecthome_position, away_position
assistantsobjectfirst_assistant_id, second_assistant_id, fourth_assistant_id
weather_reportobjectWeather report if exist (code,type,temperature in fahrenheit or celcius, clouds,humidity,pressure,wind,...)

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"
            },
...
        

Livescores Ended#back to top

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

GETGet Ended Matches

API Reference

URI Paramters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringended

Response

idintegerThe id for this match
statusintegerThe status for this match
pitchstringPith of event
referee_idreferee_idReferee's id
round_idintegerId of round for this match (if have)
season_idintegerId of season for this match
stage_idintegerPith of event
group_idintegerId of the group for Cups
aggregate_idaggregate_idAggregate id
winner_team_idintegerSometimes this parameter is needed
venue_idintegerVenue id
legstringExample 1/1
deletedbooleanIf there's a mistake in this event, response will be true
timeobjectdatetime, date, time, minute(playing), timestamp, timezone
teamsobjecthome(id,name,short_code,img,form,coach_id,color,kit_colors), away(id,name,short_code,img,form,coach_id,color,kit_colors)
leagueobjectid, name, type, country_id, country_name, country_flag
scoresobjecthome_score, away_score, ht_score, ft_score, et_score, ps_score
standingsobjecthome_position, away_position
assistantsobjectfirst_assistant_id, second_assistant_id, fourth_assistant_id
weather_reportobjectWeather report if exist (code,type,temperature in fahrenheit or celcius, clouds,humidity,pressure,wind,...)

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
        }
    ],
...
 

Fixtures by Date#back to top

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

GETGet Fixtures By date

URI Parameters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringschedule
ddateYYYY-MM-DD
pageintegerPAGE_NUMBER

Response

idintegerThe id for this match
statusintegerThe status for this match
pitchstringpitch conditions
referee_idreferee_idReferee's id
round_idintegerId of round for this match (if have)
season_idintegerId of season for this match
stage_idintegerPith of event
group_idintegerId of the group for Cups
aggregate_idaggregate_idAggregate id
winner_team_idintegerSometimes this parameter is needed
venue_idintegerVenue id
legstringExample 1/1
deletedbooleanIf there's a mistake in this event, response will be true
timeobjectdatetime, date, time, minute(playing), timestamp, timezone
teamsobjecthome(id,name,short_code,img,form,coach_id,color,kit_colors), away(id,name,short_code,img,form,coach_id,color,kit_colors)
leagueobjectid, name, type, country_id, country_name, country_flag
scoresobjecthome_score, away_score, ht_score, ft_score, et_score, ps_score
standingsobjecthome_position, away_position
assistantsobjectfirst_assistant_id, second_assistant_id, fourth_assistant_id
weather_reportobjectWeather report if exist (code,type,temperature in fahrenheit or celcius, clouds,humidity,pressure,wind,...)

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"
            },
...

Fixtures by Date / Country#back to top

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

GETGet Fixtures By Date and Country ID

API Reference

URI Parameters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringschedule
ddateYYYY-MM-DD
country_idintegerCOUNTRY_ID
pageintegerPAGE_NUMBER

Response

idintegerThe id for this match
statusintegerThe status for this match
pitchstringpitch conditions
referee_idreferee_idReferee's id
round_idintegerId of round for this match (if have)
season_idintegerId of season for this match
stage_idintegerPith of event
group_idintegerId of the group for Cups
aggregate_idaggregate_idAggregate id
winner_team_idintegerSometimes this parameter is needed
venue_idintegerVenue id
legstringExample 1/1
deletedbooleanIf there's a mistake in this event, response will be true
timeobjectdatetime, date, time, minute(playing), timestamp, timezone
teamsobjecthome(id,name,short_code,img,form,coach_id,color,kit_colors), away(id,name,short_code,img,form,coach_id,color,kit_colors)
leagueobjectid, name, type, country_id, country_name, country_flag
scoresobjecthome_score, away_score, ht_score, ft_score, et_score, ps_score
standingsobjecthome_position, away_position
assistantsobjectfirst_assistant_id, second_assistant_id, fourth_assistant_id
weather_reportobjectWeather report if exist (code,type,temperature in fahrenheit or celcius, clouds,humidity,pressure,wind,...)

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
        },
...

Fixtures by Date / League (Current Season)#back to top

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

GETGet Fixtures By Date and League ID

API Reference

URI Parameters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringschedule
ddateYYYY-MM-DD
country_idintegerCOUNTRY_ID
pageintegerPAGE_NUMBER

Response

idintegerThe id for this match
statusintegerThe status for this match
pitchstringpitch conditions
referee_idreferee_idReferee's id
round_idintegerId of round for this match (if have)
season_idintegerId of season for this match
stage_idintegerPith of event
group_idintegerId of the group for Cups
aggregate_idaggregate_idAggregate id
winner_team_idintegerSometimes this parameter is needed
venue_idintegerVenue id
legstringExample 1/1
deletedbooleanIf there's a mistake in this event, response will be true
timeobjectdatetime, date, time, minute(playing), timestamp, timezone
teamsobjecthome(id,name,short_code,img,form,coach_id,color,kit_colors), away(id,name,short_code,img,form,coach_id,color,kit_colors)
leagueobjectid, name, type, country_id, country_name, country_flag
scoresobjecthome_score, away_score, ht_score, ft_score, et_score, ps_score
standingsobjecthome_position, away_position
assistantsobjectfirst_assistant_id, second_assistant_id, fourth_assistant_id
weather_reportobjectWeather report if exist (code,type,temperature in fahrenheit or celcius, clouds,humidity,pressure,wind,...)

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
        },
...

Fixtures by Date / Season#back to top

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

GETGet Fixtures By Date and Season ID

API Reference

URI Parameters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringseason
ddateYYYY-MM-DD
idintegerSEASON_ID
pageintegerPAGE_NUMBER

Response

idintegerThe id for this match
statusintegerThe status for this match
pitchstringpitch conditions
referee_idreferee_idReferee's id
round_idintegerId of round for this match (if have)
season_idintegerId of season for this match
stage_idintegerPith of event
group_idintegerId of the group for Cups
aggregate_idaggregate_idAggregate id
winner_team_idintegerSometimes this parameter is needed
venue_idintegerVenue id
legstringExample 1/1
deletedbooleanIf there's a mistake in this event, response will be true
timeobjectdatetime, date, time, minute(playing), timestamp, timezone
teamsobjecthome(id,name,short_code,img,form,coach_id,color,kit_colors), away(id,name,short_code,img,form,coach_id,color,kit_colors)
leagueobjectid, name, type, country_id, country_name, country_flag
scoresobjecthome_score, away_score, ht_score, ft_score, et_score, ps_score
standingsobjecthome_position, away_position
assistantsobjectfirst_assistant_id, second_assistant_id, fourth_assistant_id
weather_reportobjectWeather report if exist (code,type,temperature in fahrenheit or celcius, clouds,humidity,pressure,wind,...)

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
        },
...
        

Fixtures by Date / Stage#back to top

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

GETGet Fixtures By Date and Stage ID

API Reference

URI Parameters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringstages
ddateYYYY-MM-DD
idintegerSTAGE_ID
pageintegerPAGE_NUMBER

Response

idintegerThe id for this match
statusintegerThe status for this match
pitchstringpitch conditions
referee_idreferee_idReferee's id
round_idintegerId of round for this match (if have)
season_idintegerId of season for this match
stage_idintegerPith of event
group_idintegerId of the group for Cups
aggregate_idaggregate_idAggregate id
winner_team_idintegerSometimes this parameter is needed
venue_idintegerVenue id
legstringExample 1/1
deletedbooleanIf there's a mistake in this event, response will be true
timeobjectdatetime, date, time, minute(playing), timestamp, timezone
teamsobjecthome(id,name,short_code,img,form,coach_id,color,kit_colors), away(id,name,short_code,img,form,coach_id,color,kit_colors)
leagueobjectid, name, type, country_id, country_name, country_flag
scoresobjecthome_score, away_score, ht_score, ft_score, et_score, ps_score
standingsobjecthome_position, away_position
assistantsobjectfirst_assistant_id, second_assistant_id, fourth_assistant_id
weather_reportobjectWeather report if exist (code,type,temperature in fahrenheit or celcius, clouds,humidity,pressure,wind,...)

Response Example

{
    "data": [
        {
            "id": 11900655,
            "status": 0,
            "pitch": null,
            "referee_id": 15280,
            "round_id": 169707,
            "season_id": 16074,
            "stage_id": 77443900,
            "group_id": null,
            "aggregate_id": null,
            "winner_team_id": null,
            "venue_id": 50,
            "leg": "1/1",
            "deleted": false,
            "time": {
                "datetime": "2019-12-21 12:30:00",
                "date": "2019-12-21",
                "time": "12:30:00",
                "minute": null,
                "timestamp": 1576931400,
                "timezone": "UTC"
            },
            "teams": {
                "home": {
                    "id": 51,
                    "name": "Everton",
                    "short_code": "EVE",
                    "img": "https://cdn.soccersapi.com/images/soccer/teams/150/51.png",
                    "form": null,
                    "coach_id": 6971142,
                    "color": null,
                    "kit_colors": null
                },
                "away": {
                    "id": 57,
                    "name": "Arsenal",
                    "short_code": "ARS",
                    "img": "https://cdn.soccersapi.com/images/soccer/teams/150/57.png",
                    "form": null,
                    "coach_id": 186,
                    "color": null,
                    "kit_colors": null
                }
            },
            "league": {
                "id": 46,
                "name": "Premier League",
                "type": "domestic",
                "country_id": 500,
                "country_name": "England",
                "country_flag": ""
            },
            "scores": {
                "home_score": 0,
                "away_score": 0,
                "ht_score": null,
                "ft_score": null,
                "et_score": null,
                "ps_score": null
            },
            "standings": {
                "home_position": 16,
                "away_position": 10
            },
            "assistants": {
                "first_assistant_id": 12749,
                "second_assistant_id": 12056,
                "fourth_assistant_id": null
            },
            "weather_report": null
        },
        {
            "id": 11900652,
            "status": 0,
            "pitch": null,
            "referee_id": 15307,
            "round_id": 169707,
            "season_id": 16074,
            "stage_id": 77443900,
            "group_id": null,
            "aggregate_id": null,
            "winner_team_id": null,
            "venue_id": 418,
            "leg": "1/1",
            "deleted": false,
            "time": {
                "datetime": "2019-12-21 15:00:00",
                "date": "2019-12-21",
                "time": "15:00:00",
                "minute": null,
                "timestamp": 1576940400,
                "timezone": "UTC"
            },
            "teams": {
                "home": {
                    "id": 90,
                    "name": "AFC Bournemouth",
                    "short_code": "BOU",
                    "img": "https://cdn.soccersapi.com/images/soccer/teams/150/90.png",
                    "form": null,
                    "coach_id": 523949,
                    "color": null,
                    "kit_colors": null
                },
                "away": {
                    "id": 65,
                    "name": "Burnley",
                    "short_code": "BUR",
                    "img": "https://cdn.soccersapi.com/images/soccer/teams/150/65.png",
                    "form": null,
                    "coach_id": 455499,
                    "color": null,
                    "kit_colors": null
                }
            },
            "league": {
                "id": 46,
                "name": "Premier League",
                "type": "domestic",
                "country_id": 500,
                "country_name": "England",
                "country_flag": ""
            },
            "scores": {
                "home_score": 0,
                "away_score": 0,
                "ht_score": null,
                "ft_score": null,
                "et_score": null,
                "ps_score": null
            },
            "standings": {
                "home_position": 14,
                "away_position": 12
            },
            "assistants": {
                "first_assistant_id": 12121,
                "second_assistant_id": 12125,
                "fourth_assistant_id": null
            },
            "weather_report": null
        },
        {
            "id": 11900653,
            "status": 0,
            "pitch": null,
            "referee_id": 15331,
            "round_id": 169707,
            "season_id": 16074,
            "stage_id": 77443900,
            "group_id": null,
            "aggregate_id": null,
            "winner_team_id": null,
            "venue_id": 43,
            "leg": "1/1",
            "deleted": false,
            "time": {
                "datetime": "2019-12-21 15:00:00",
                "date": "2019-12-21",
                "time": "15:00:00",
                "minute": null,
                "timestamp": 1576940400,
                "timezone": "UTC"
            },
            "teams": {
                "home": {
                    "id": 53,
                    "name": "Aston Villa",
                    "short_code": "AVA",
                    "img": "https://cdn.soccersapi.com/images/soccer/teams/150/53.png",
                    "form": null,
                    "coach_id": 524275,
                    "color": null,
                    "kit_colors": null
                },
                "away": {
                    "id": 103,
                    "name": "Southampton",
                    "short_code": "SOU",
                    "img": "https://cdn.soccersapi.com/images/soccer/teams/150/103.png",
                    "form": null,
                    "coach_id": 524335,
                    "color": null,
                    "kit_colors": null
                }
            },
            "league": {
                "id": 46,
                "name": "Premier League",
                "type": "domestic",
                "country_id": 500,
                "country_name": "England",
                "country_flag": ""
            },
            "scores": {
                "home_score": 0,
                "away_score": 0,
                "ht_score": null,
                "ft_score": null,
                "et_score": null,
                "ps_score": null
            },
            "standings": {
                "home_position": 17,
                "away_position": 18
            },
            "assistants": {
                "first_assistant_id": 12064,
                "second_assistant_id": 12128,
                "fourth_assistant_id": null
            },
            "weather_report": null
        },
...
        

Fixtures by Date / Round#back to top

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

GETGet Fixtures By Date and Round ID

API Reference

URI Parameters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringrounds
ddateYYYY-MM-DD
idintegerROUND_ID
pageintegerPAGE_NUMBER

Response

idintegerThe id for this match
statusintegerThe status for this match
pitchstringpitch conditions
referee_idreferee_idReferee's id
round_idintegerId of round for this match (if have)
season_idintegerId of season for this match
stage_idintegerPith of event
group_idintegerId of the group for Cups
aggregate_idaggregate_idAggregate id
winner_team_idintegerSometimes this parameter is needed
venue_idintegerVenue id
legstringExample 1/1
deletedbooleanIf there's a mistake in this event, response will be true
timeobjectdatetime, date, time, minute(playing), timestamp, timezone
teamsobjecthome(id,name,short_code,img,form,coach_id,color,kit_colors), away(id,name,short_code,img,form,coach_id,color,kit_colors)
leagueobjectid, name, type, country_id, country_name, country_flag
scoresobjecthome_score, away_score, ht_score, ft_score, et_score, ps_score
standingsobjecthome_position, away_position
assistantsobjectfirst_assistant_id, second_assistant_id, fourth_assistant_id
weather_reportobjectWeather report if exist (code,type,temperature in fahrenheit or celcius, clouds,humidity,pressure,wind,...)

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
        },
...

Fixtures by Season#back to top

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

GETGet Fixtures By Season ID

API Reference

URI Parameters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringseason
season_idintegerSEASON_ID

Response

idintegerThe id for this match
statusintegerThe status for this match
status_namestringThe name of the status
status_periodstringThe name of the period
pitchstringpitch conditions
referee_idreferee_idReferee's id
round_idintegerId of round for this match (if have)
season_idintegerId of season for this match
season_namestringThe name of season
stage_idintegerID of the stage
stage_namestringThe name of stage
group_idintegerId of the group for Cups
group_namestringThe name of the group
aggregate_idaggregate_idAggregate id
winner_team_idintegerThe team that win on this event
venue_idintegerThe Venue id
legstringExample 1/1
deletedbooleanIf there's a mistake in this event, response will be true
timeobjectdatetime, date, time, minute(inplay), timestamp, timezone
teamsobjecthome(id), away(id)
homeobjectid, name, short_code, img, form, coach_id, color, kit_colors
awayobjectid, name, short_code, img, form, coach_id, color, kit_colors
leagueobjectid, name, type, country_id, country_name, country_flag
scoresobjecthome_score, away_score, ht_score, ft_score, et_score, ps_score
standingsobjecthome_position, away_position
assistantsobjectfirst_assistant_id, second_assistant_id, fourth_assistant_id
coverageobjecthas_lineups, has_tvs
weather_reportstringWeather conditions

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
        },
...

Fixtures by Season / Team#back to top

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

GETGet Fixtures By Season ID and Team ID

API Reference

URI Parameters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringseason
season_idintegerSEASON_ID
team_idintegerTEAM_ID

Response

idintegerThe id for this match
statusintegerThe status for this match
status_namestringThe name of the status
status_periodstringThe name of the period
pitchstringpitch conditions
referee_idreferee_idReferee's id
round_idintegerId of round for this match (if have)
season_idintegerId of season for this match
season_namestringThe name of season
stage_idintegerID of the stage
stage_namestringThe name of stage
group_idintegerId of the group for Cups
group_namestringThe name of the group
aggregate_idaggregate_idAggregate id
winner_team_idintegerThe team that win on this event
venue_idintegerThe Venue id
legstringExample 1/1
deletedbooleanIf there's a mistake in this event, response will be true
timeobjectdatetime, date, time, minute(inplay), timestamp, timezone
teamsobjecthome(id), away(id)
homeobjectid, name, short_code, img, form, coach_id, color, kit_colors
awayobjectid, name, short_code, img, form, coach_id, color, kit_colors
leagueobjectid, name, type, country_id, country_name, country_flag
scoresobjecthome_score, away_score, ht_score, ft_score, et_score, ps_score
standingsobjecthome_position, away_position
assistantsobjectfirst_assistant_id, second_assistant_id, fourth_assistant_id
coverageobjecthas_lineups, has_tvs
weather_reportstringWeather conditions

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
        },
...

Fixtures by Stage#back to top

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

GETGet Fixtures By Stage ID

API Reference

URI Parameters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringstage
idintegerSTAGE_ID

Response

idintegerThe id for this match
statusintegerThe status for this match
status_namestringThe name of the status
status_periodstringThe name of the period
pitchstringpitch conditions
referee_idreferee_idReferee's id
round_idintegerId of round for this match (if have)
season_idintegerId of season for this match
season_namestringThe name of season
stage_idintegerID of the stage
stage_namestringThe name of stage
group_idintegerId of the group for Cups
group_namestringThe name of the group
aggregate_idaggregate_idAggregate id
winner_team_idintegerThe team that win on this event
venue_idintegerThe Venue id
legstringExample 1/1
deletedbooleanIf there's a mistake in this event, response will be true
timeobjectdatetime, date, time, minute(inplay), timestamp, timezone
teamsobjecthome(id), away(id)
homeobjectid, name, short_code, img, form, coach_id, color, kit_colors
awayobjectid, name, short_code, img, form, coach_id, color, kit_colors
leagueobjectid, name, type, country_id, country_name, country_flag
scoresobjecthome_score, away_score, ht_score, ft_score, et_score, ps_score
standingsobjecthome_position, away_position
assistantsobjectfirst_assistant_id, second_assistant_id, fourth_assistant_id
coverageobjecthas_lineups, has_tvs
weather_reportstringWeather conditions

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": 11352867,
            "status": 3,
            "pitch": null,
            "referee_id": 11767,
            "round_id": 159790,
            "season_id": 15512,
            "stage_id": 77441847,
            "group_id": 207832,
            "aggregate_id": null,
            "winner_team_id": null,
            "venue_id": null,
            "leg": "1/1",
            "deleted": false,
            "time": {
                "datetime": "2019-03-22 17:00:00",
                "date": "2019-03-22",
                "time": "17:00:00",
                "minute": 90,
                "timestamp": 1553274000,
                "timezone": "UTC"
            },
            "teams": {
                "home": {
                    "id": 18728
                },
                "away": {
                    "id": 18874
                }
            },
            "league": {
                "id": 1363
            },
            "scores": {
                "home_score": 1,
                "away_score": 1,
                "ht_score": "0-0",
                "ft_score": "1-1",
                "et_score": null,
                "ps_score": null
            },
            "standings": {
                "home_position": 1,
                "away_position": 5
            },
            "assistants": {
                "first_assistant_id": 12166,
                "second_assistant_id": 15971,
                "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
            }
        },
...

Fixtures by Stage / Team#back to top

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

GETGet Fixtures By Stage ID and Team

API Reference

URI Parameters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringstage
idintegerSTAGE_ID

Response

idintegerThe id for this match
statusintegerThe status for this match
status_namestringThe name of the status
status_periodstringThe name of the period
pitchstringpitch conditions
referee_idreferee_idReferee's id
round_idintegerId of round for this match (if have)
season_idintegerId of season for this match
season_namestringThe name of season
stage_idintegerID of the stage
stage_namestringThe name of stage
group_idintegerId of the group for Cups
group_namestringThe name of the group
aggregate_idaggregate_idAggregate id
winner_team_idintegerThe team that win on this event
venue_idintegerThe Venue id
legstringExample 1/1
deletedbooleanIf there's a mistake in this event, response will be true
timeobjectdatetime, date, time, minute(inplay), timestamp, timezone
teamsobjecthome(id), away(id)
homeobjectid, name, short_code, img, form, coach_id, color, kit_colors
awayobjectid, name, short_code, img, form, coach_id, color, kit_colors
leagueobjectid, name, type, country_id, country_name, country_flag
scoresobjecthome_score, away_score, ht_score, ft_score, et_score, ps_score
standingsobjecthome_position, away_position
assistantsobjectfirst_assistant_id, second_assistant_id, fourth_assistant_id
coverageobjecthas_lineups, has_tvs
weather_reportstringWeather conditions

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
            }
        },
...

Fixtures by Round#back to top

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

GETGet Fixtures By Round ID

API Reference

URI Parameters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringround
round_idintegerROUND_ID

Response

idintegerThe id for this match
statusintegerThe status for this match
status_namestringThe name of the status
status_periodstringThe name of the period
pitchstringpitch conditions
referee_idreferee_idReferee's id
round_idintegerId of round for this match (if have)
season_idintegerId of season for this match
season_namestringThe name of season
stage_idintegerID of the stage
stage_namestringThe name of stage
group_idintegerId of the group for Cups
group_namestringThe name of the group
aggregate_idaggregate_idAggregate id
winner_team_idintegerThe team that win on this event
venue_idintegerThe Venue id
legstringExample 1/1
deletedbooleanIf there's a mistake in this event, response will be true
timeobjectdatetime, date, time, minute(inplay), timestamp, timezone
teamsobjecthome(id), away(id)
homeobjectid, name, short_code, img, form, coach_id, color, kit_colors
awayobjectid, name, short_code, img, form, coach_id, color, kit_colors
leagueobjectid, name, type, country_id, country_name, country_flag
scoresobjecthome_score, away_score, ht_score, ft_score, et_score, ps_score
standingsobjecthome_position, away_position
assistantsobjectfirst_assistant_id, second_assistant_id, fourth_assistant_id
coverageobjecthas_lineups, has_tvs
weather_reportstringWeather conditions

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
        },
...
    

Fixtures by Round / Team#back to top

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

GETGet Fixtures By Round ID and Team ID

API Reference

URI Parameters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringround
round_idintegerROUND_ID
team_idintegerTEAM_ID

Response

idintegerThe id for this match
statusintegerThe status for this match
status_namestringThe name of the status
status_periodstringThe name of the period
pitchstringpitch conditions
referee_idreferee_idReferee's id
round_idintegerId of round for this match (if have)
season_idintegerId of season for this match
season_namestringThe name of season
stage_idintegerID of the stage
stage_namestringThe name of stage
group_idintegerId of the group for Cups
group_namestringThe name of the group
aggregate_idaggregate_idAggregate id
winner_team_idintegerThe team that win on this event
venue_idintegerThe Venue id
legstringExample 1/1
deletedbooleanIf there's a mistake in this event, response will be true
timeobjectdatetime, date, time, minute(inplay), timestamp, timezone
teamsobjecthome(id), away(id)
homeobjectid, name, short_code, img, form, coach_id, color, kit_colors
awayobjectid, name, short_code, img, form, coach_id, color, kit_colors
leagueobjectid, name, type, country_id, country_name, country_flag
scoresobjecthome_score, away_score, ht_score, ft_score, et_score, ps_score
standingsobjecthome_position, away_position
assistantsobjectfirst_assistant_id, second_assistant_id, fourth_assistant_id
coverageobjecthas_lineups, has_tvs
weather_reportstringWeather conditions

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
        }
    ],
...
    

Match by ID#back to top

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

GETGet Match By ID

API Reference

URI Parameters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringinfo
idintegerMATCH_ID

Response

id integer The id of the event
status integer The id of status (check Statuses and Explanation in this doc for see the reference for this number)
time object datetime, date, time, timestamp, timezone, minute playing
teams object home(id, name, img, form, coach_id),away(id, name, img, form,coach_id)
league object id, name, country_id, country_name, country_flag
scores object home_score, away_score, ht_score, ft_score, et_score
venue_id integer Id of venue
referee_id integer Id of referee
season_id integer Id of season for this match
stage_id integer Id of stage for this match
round_id integer Id of round for this match (if have)

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
    },
...

Match Commentary#back to top

The Match Commentary Endpoint gives you commentaries by Match ID

GETGet Match Commentary By Match ID

API Reference

Description

Headers application/json
Endpoint https://api.soccersapi.com/v2.2/fixtures/?user={YOUR_USER_NAME}&token={YOUR_TOKEN}&t=match_comments&id={MATCH_ID}
Example https://api.soccersapi.com/v2.2/fixtures/?user=user1&token=Z5R9jArYsKZmHmP47&t=match_comments&id=15006543
Extra Add (&order=desc) for have new lines first
Paginated No, this endpoint is not paginated

URI Parameters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringmatch_comments
idintegerMATCH_ID
orderstringasc / desc

Response

important boolean If is important (goals, cards,..)
order integer Order of the commentary (if you add &order=desc on call, you'll have on the top the newests)
goal boolean If is goal
minute integer In wich minute happened
extra_minute integer If happened in extra time
comment string What happened

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."
        },
...

Match Events#back to top

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

GETGet Match Events By Match ID

API Reference

URI Parameters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringmatch_events
idstringMATCH_ID

Response

team_id integer Id of the team
player_id integer Id of the player
player_name string Name of the player
related_player_id integer Id of the player in relation
related_player_name string Name of the player
minute integer Minute
extra_minute integer If happened in extra time
reason string Happen in cards
injuried string If was injuried
result string Current result if goal

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
        },
...

Match Lineups#back to top

The Lineups Endpoint gives you starting Lineups by Match ID

GETGet Lineups By Match ID

API Reference

URI Parameters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringmatch_lineups
idstringMATCH_ID

Response

team_idintegerThe id for the team
player_idintegerThe id of the player
player_namestringThe name of the player
numberstringThe number of the player
positionstringThe position of the player
formation_positionstringThe formation position of the player
posxstringThe posx (position X-axis) in formation of the player
posystringThe posy (position Y-axis) in formation of the player
statsobjectshots, goals, fouls, cards, passing, other
shotsobjectshots_total, shots_on_goal
goalsobjectscored, conceded
foulsobjectdrawn, committed
cardsobjectyellowcards, redcards
passingobjecttotal_crosses, crosses_accuracy, passes, passes_accuracy
otherobjectassists, offsides, saves, pen_scored, pen_missed, pen_saved, tackles, blocks, interceptions, clearances, minutes_played

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
                },
...

Match Bench#back to top

The Match Bench Endpoint gives you the bench of both teams

GETGet Bench By Match ID

API Reference

URI Parameters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringmatch_bench
idstringMATCH_ID

Response

team_idintegerThe id for the team
player_idintegerThe id of the player
player_namestringThe name of the player
numberstringThe number of the player
positionstringThe position of the player
formation_positionstringThe formation position of the player
posxstringThe posx (position X-axis) in formation of the player
posystringThe posy (position Y-axis) in formation of the player
statsobjectshots, goals, fouls, cards, passing, other
shotsobjectshots_total, shots_on_goal
goalsobjectscored, conceded
foulsobjectdrawn, committed
cardsobjectyellowcards, redcards
passingobjecttotal_crosses, crosses_accuracy, passes, passes_accuracy
otherobjectassists, offsides, saves, pen_scored, pen_missed, pen_saved, tackles, blocks, interceptions, clearances, minutes_played

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"
            },
...

Match Stats#back to top

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

GETGet Match Statistics By Match ID

API Reference

URI Parameters

user string YOUR_USER
token string YOUR_TOKEN
t string match
id integer MATCH_ID
team_id integer The id of the team
shots object total,ongoal,offgoal,blocked,insidebox,outsidebox
passes object total,accurate,percentage
attacks object attacks,dangerous_attacks
fouls integer Number of fouls
corners integer Number of corners
offsides integer Number of offsides
possessiontime integer Percentatge of possessiontime
yellowcards integer Number of yellowcards
redcards integer Number of redcards
yellowredcards integer Number of yellowredcards
saves integer Number of saves
substitutions integer Number of substitutions
goal_kick integer Number of kicks to goal
goal_attempts integer Number of goals attempts
free_kick integer Number of free kicks
throw_in integer Number of throw in
ball_safe integer Number of balls safe
goals integer Number of goals
penalties integer Number of penalties
injuries integer Number of injuries

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
        }
    ],
...

League Stats#back to top

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

GET Get League Statistics by League ID (Current Season)

API Reference

URI Parameters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringleague
idintegerLEAGUE_ID
season_idintegerThe id of the season
number_of_teamsintegerNumber of teams
number_of_matchesintegerNumber of matches
number_of_matches_playedintegerNumber of matches played
number_of_goalsintegerNumber of goals scored
matches_both_teams_scoredintegerNumber of matches on both teams scored
number_of_yellowcardsintegerNumber of yellow cards
number_of_yellowredcardsintegerNumber of yellowred cards
number_of_redcardsintegerNumber of redcards
avg_goals_per_matchintegerAverage goals per match
avg_yellowcards_per_matchintegerAverage yellowreds per match
avg_redcards_per_matchintegerAverage redcards per match
team_with_most_goals_idintegerTeam with most goals ID
team_with_most_conceded_goals_idintegerTeam with most conceded goals ID
team_with_most_goals_per_match_idintegerTeam with most goals per match ID
season_topscorer_idintegerSeason topscorer ID
team_most_cleansheets_idintegerTeam most cleansheets ID
team_most_cleansheets_numberintegerTeam most cleansheets number
goals_scored_minutesobject0-15, 15-30, 30-45, 45-60, 60-75, 75-90
goalkeeper_most_cleansheets_idintegerGoalkeeper most cleansheets ID
goalkeeper_most_cleansheets_numberintegerGoalkeeper most cleansheets number
goal_scored_every_minutesintegerGoal scored every minutes
bttsintegerBoth teams to score
goal_lineobjectover, under
overinteger0_5, 1_5, 2_5, 3_5, 4_5, 5_5
underinteger0_5, 1_5, 2_5, 3_5, 4_5, 5_5
{
    "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
                }
            }
        }
    },
...

Season Stats#back to top

This endpoint allows you to get Season stats by ID.

GET Get Season Statistics by Season ID

API Reference

URI Parameters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringseason
idintegerSEASON_ID
season_idintegerThe id of the season
number_of_teamsintegerNumber of teams
number_of_matchesintegerNumber of matches
number_of_matches_playedintegerNumber of matches played
number_of_goalsintegerNumber of goals scored
matches_both_teams_scoredintegerNumber of matches on both teams scored
number_of_yellowcardsintegerNumber of yellow cards
number_of_yellowredcardsintegerNumber of yellowred cards
number_of_redcardsintegerNumber of redcards
avg_goals_per_matchintegerAverage goals per match
avg_yellowcards_per_matchintegerAverage yellowreds per match
avg_redcards_per_matchintegerAverage redcards per match
team_with_most_goals_idintegerTeam with most goals ID
team_with_most_conceded_goals_idintegerTeam with most conceded goals ID
team_with_most_goals_per_match_idintegerTeam with most goals per match ID
season_topscorer_idintegerSeason topscorer ID
team_most_cleansheets_idintegerTeam most cleansheets ID
team_most_cleansheets_numberintegerTeam most cleansheets number
goals_scored_minutesobject0-15, 15-30, 30-45, 45-60, 60-75, 75-90
goalkeeper_most_cleansheets_idintegerGoalkeeper most cleansheets ID
goalkeeper_most_cleansheets_numberintegerGoalkeeper most cleansheets number
goal_scored_every_minutesintegerGoal scored every minutes
bttsintegerBoth teams to score
goal_lineobjectover, under
overinteger0_5, 1_5, 2_5, 3_5, 4_5, 5_5
underinteger0_5, 1_5, 2_5, 3_5, 4_5, 5_5
{
    "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
                }
            }
        }
    },
...

Team Stats#back to top

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

GET Get Team Statistics by Team ID and Season ID

API Reference

URI Parameters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringteam
idintegerTEAM_ID
season_idintegerSEASON_ID
stage_idintegerThe id of the stage
winobjecttotal, home, away
drawobjecttotal, home, away
lostobjecttotal, home, away
goals_forobjecttotal, home, away
goals_againstobjecttotal, home, away
clean_sheetobjecttotal, home, away
failed_to_scoreobjecttotal, home, away
scoring_minutesobjectperiod
periodobjectminute, count, percentage
avg_goals_per_game_scoredintegerThe id of the stage
avg_goals_per_game_concededintegerThe id of the stage
avg_first_goal_scoredintegerThe id of the stage
avg_first_goal_concededintegerThe id of the stage
attacksintegerThe number of attacks
dangerous_attacksintegerThe number of dangerous attacks
avg_ball_possession_percentageintegerThe percentaje of ball possesion
foulsintegerThe number of fouls
avg_fouls_per_gameintegerThe average of fouls per game
offsidesintegerThe number of offsides
redcardsintegerThe number of redcards
yellowcardsintegerThe number of yellowcards
shots_blockedintegerThe number of shots blocked
shots_off_targetintegerThe number of shots off target
avg_shots_off_target_per_gameintegerThe average of shots off target per game
shots_on_targetintegerThe number of shots on target
avg_shots_on_target_per_gameintegerThe average of shots on target per game
avg_cornersintegerThe average of corners per game
total_cornersintegerThe number of corners
bttsintegerThe number of games on both teams to score
{
    "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
                        }
                    }
                }
            }
        }
    },
...

Player Stats / Season#back to top

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

GET Get Player Statistics by Player ID and Season ID

URI Parameters

user string YOUR_USER
token string YOUR_TOKEN
t string player
id integer PLAYER_ID
season_id integer SEASON_ID

Response Attributes

player_id integer The id of the player
number string The number of the player
captain boolean Boolean if the player is captain
position_id integer The id of the position
injured boolean true or false
minutes_played integer The amount of minutes played in the current season
appearences integer Number of appearences
lineups integer Number of lineups
substitute_in integer Number of substitutes in
substitute_out integer Number of substitutes out
substitutes_on_bench integer Number of substitutes on bench
goals integer Number of goals
assists integer Number of assists
saves integer Number of saves
inside_box_saves integer Number of inside box saves
dispossesed boolean Number of dispossesed
interceptions integer Number of interceptions
yellowcards integer Number of yellowcards
yellowred integer Number of yellowreds
redcards integer Number of redcards
tackles integer Number of tackles
blocks integer Number of blocks
hit_post integer Number of hit post
fouls object commited, drawn
crosses object total, accurate
dribbles object attempts, success, dribbled_past
duels object total, won
passes object total, accuracy, key_passes
penalties object won, scores, missed, committed, saves

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
            }
        }
    },
...

Match H2H#back to top

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.

GETGet Match Head to Head

API Reference

URI Parameters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringmatch
idstringMATCH_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"
                    },
...

H2H Team vs Team#back to top

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.

GETGet team vs team Head to Head

API Reference

URI Parameters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringmatch
team1intTEAM1_ID
team2intTEAM2_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"
                    },
...

Topscorers (Leaders)#back to top

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

GET Get Topscorers By Season ID

API Reference

URI Parameters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringtopscorers
season_idintegerSEASON_ID
goalscorersobjectposition, season_id, player_id, team_id, stage_id, goals, penalty_goals, type
positionintegerPlayer position
season_idintegerSeason ID
player_idintegerPlayer ID
team_idintegerTeam ID
stage_idintegerStage ID
goalsintegerNumber of goals
penalty_goalsintegernumber of penalty goals
typeintegergoals
cardscorersobjectposition, season_id, player_id, team_id, stage_id, yellowcards, redcards, type
positionintegerPlayer position
season_idintegerSeason ID
player_idintegerPlayer ID
team_idintegerTeam ID
stage_idintegerStage ID
yellowcardsintegerNumber of yellowcards
redcardsintegernumber of redcards
typeintegercards
assistscorersobjectposition, season_id, player_id, team_id, stage_id, assists, type
positionintegerPlayer position
season_idintegerSeason ID
player_idintegerPlayer ID
team_idintegerTeam ID
stage_idintegerStage ID
assistsintegerNumber of assists
typeintegerassists

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
        },
 
...

Topassists (Leaders)#back to top

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

GET Get Topassists By Season ID

API Reference

URI Parameters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringtopassists
season_idintegerSEASON_ID
goalscorersobjectposition, season_id, player_id, team_id, stage_id, goals, penalty_goals, type
positionintegerPlayer position
season_idintegerSeason ID
player_idintegerPlayer ID
team_idintegerTeam ID
stage_idintegerStage ID
goalsintegerNumber of goals
penalty_goalsintegernumber of penalty goals
typeintegergoals
cardscorersobjectposition, season_id, player_id, team_id, stage_id, yellowcards, redcards, type
positionintegerPlayer position
season_idintegerSeason ID
player_idintegerPlayer ID
team_idintegerTeam ID
stage_idintegerStage ID
yellowcardsintegerNumber of yellowcards
redcardsintegernumber of redcards
typeintegercards
assistscorersobjectposition, season_id, player_id, team_id, stage_id, assists, type
positionintegerPlayer position
season_idintegerSeason ID
player_idintegerPlayer ID
team_idintegerTeam ID
stage_idintegerStage ID
assistsintegerNumber of assists
typeintegerassists

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
        },

...

Topcards (Leaders)#back to top

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

GET Get Topscorers By Season ID

API Reference

URI Parameters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringtopcards
season_idintegerSEASON_ID
goalscorersobjectposition, season_id, player_id, team_id, stage_id, goals, penalty_goals, type
positionintegerPlayer position
season_idintegerSeason ID
player_idintegerPlayer ID
team_idintegerTeam ID
stage_idintegerStage ID
goalsintegerNumber of goals
penalty_goalsintegernumber of penalty goals
typeintegergoals
cardscorersobjectposition, season_id, player_id, team_id, stage_id, yellowcards, redcards, type
positionintegerPlayer position
season_idintegerSeason ID
player_idintegerPlayer ID
team_idintegerTeam ID
stage_idintegerStage ID
yellowcardsintegerNumber of yellowcards
redcardsintegernumber of redcards
typeintegercards
assistscorersobjectposition, season_id, player_id, team_id, stage_id, assists, type
positionintegerPlayer position
season_idintegerSeason ID
player_idintegerPlayer ID
team_idintegerTeam ID
stage_idintegerStage ID
assistsintegerNumber of assists
typeintegerassists

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
        },

...

Bookmakers#back to top

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

GETGet Bookmakers

API Reference

URI Parameters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringlist

Response

idintegerThe id of the bookmaker
nameintegerThe name of the bookmaker
imgobjectThe logo of the bookmaker

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"
        }
    ],
...

Bookmaker by ID#back to top

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

GETGet Bookmaker by ID

API Reference

URI Parameters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringinfo
idintegerBOOKMAKER_ID

Response

idintegerThe id of the bookmaker
nameintegerThe name of the bookmaker
imgobjectThe logo of the bookmaker

Response Example

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

Markets#back to top

The Markets Endpoint gives a list of all available markets

GETGet Markets

API Reference

URI Parameters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringlist

Response

idintegerThe id of the market
nameintegerThe name of the market

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"
        }
    ],
...

Market by ID#back to top

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

GETGet Market by ID

API Reference

URI Parameters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringinfo
idintegerMARKET_ID

Response

idintegerThe id of the market
nameintegerThe name of the market

Response Example

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

Pre-Match Odds#back to top

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

GETGet Pre-Match Odds

API Reference

URI Parameters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringmatch_odds
idintegerMATCH_ID

Response

idintegerThe id of the market
namestringThe name of the market
bookmakersobjectid, name, odds
idintegerThe id of the bookmaker
namestringThe name of the bookmaker
oddsobjectlabel, value, wining, handicap, total, bookmaker_event_id, last_update
last_updateobjectdate, timezone_type, timezone

Response Example

{
    "data": [
        {
            "id": 1,
            "name": "1X2, Full Time Result",
            "bookmakers": {
                "data": [
                    {
                        "id": 2,
                        "name": "Bet365",
                        "odds": { 
                            "data": [
                                {
                                    "label": 1,
                                    "value": "1.002",
                                    "winning": null,
                                    "handicap": null,
                                    "total": null,
                                    "bookmaker_event_id": null,
                                    "last_update": {
                                        "date": null,
                                        "timezone_type": null,
                                        "timezone": null
                                    }
                                },
                                {
                                    "label": "X",
                                    "value": "51.000",
                                    "winning": null,
                                    "handicap": null,
                                    "total": null,
                                    "bookmaker_event_id": null,
                                    "last_update": {
                                        "date": null,
                                        "timezone_type": null,
                                        "timezone": null
                                    }
                                },
                                {
                                    "label": 2,
                                    "value": "151.000",
                                    "winning": null,
                                    "handicap": null,
                                    "total": null,
                                    "bookmaker_event_id": null,
                                    "last_update": {
                                        "date": null,
                                        "timezone_type": null,
                                        "timezone": null
                                    }
                                }
                            ]
                        }
                    },
                    {
                        "id": 1,
                        "name": "10Bet",
                        "odds": {
                            "data": [
                                {
                                    "label": 1,
                                    "value": "0",
                                    "winning": null,
                                    "handicap": null,
                                    "total": null,
                                    "bookmaker_event_id": null,
                                    "last_update": {
                                        "date": null,
                                        "timezone_type": null,
                                        "timezone": null
                                    }
                                },
                                {
                                    "label": "X",
                                    "value": "0",
                                    "winning": null,
                                    "handicap": null,
                                    "total": null,
                                    "bookmaker_event_id": null,
                                    "last_update": {
                                        "date": null,
                                        "timezone_type": null,
                                        "timezone": null
                                    }
                                },
                                {
                                    "label": 2,
                                    "value": "0",
                                    "winning": null,
                                    "handicap": null,
                                    "total": null,
                                    "bookmaker_event_id": null,
                                    "last_update": {
                                        "date": null,
                                        "timezone_type": null,
                                        "timezone": null
                                    }
                                }
                            ]
                        }
                    },
                    {
                        "id": 32,
                        "name": "Ladbrokes",
                        "odds": {
                            "data": [
                                {
                                    "label": 1,
                                    "value": "1.57",
                                    "winning": null,
                                    "handicap": null,
                                    "total": null,
                                    "bookmaker_event_id": null,
                                    "last_update": {
                                        "date": null,
                                        "timezone_type": null,
                                        "timezone": null
                                    }
                                },
                                {
                                    "label": "X",
                                    "value": "4.20",
                                    "winning": null,
                                    "handicap": null,
                                    "total": null,
                                    "bookmaker_event_id": null,
                                    "last_update": {
                                        "date": null,
                                        "timezone_type": null,
                                        "timezone": null
                                    }
                                },
                                {
                                    "label": 2,
                                    "value": "5.75",
                                    "winning": null,
                                    "handicap": null,
                                    "total": null,
                                    "bookmaker_event_id": null,
                                    "last_update": {
                                        "date": null,
                                        "timezone_type": null,
                                        "timezone": null
                                    }
                                }
                            ]
                        }
                    },
                    {
                        "id": 37,
                        "name": "WilliamHill",
                        "odds": {
                            "data": [
                                {
                                    "label": 1,
                                    "value": "1.53",
                                    "winning": null,
                                    "handicap": null,
                                    "total": null,
                                    "bookmaker_event_id": null,
                                    "last_update": {
                                        "date": null,
                                        "timezone_type": null,
                                        "timezone": null
                                    }
                                },
                                {
                                    "label": "X",
                                    "value": "4.33",
                                    "winning": null,
                                    "handicap": null,
                                    "total": null,
                                    "bookmaker_event_id": null,
                                    "last_update": {
                                        "date": null,
                                        "timezone_type": null,
                                        "timezone": null
                                    }
                                },
                                {
                                    "label": 2,
                                    "value": "6",
                                    "winning": null,
                                    "handicap": null,
                                    "total": null,
                                    "bookmaker_event_id": null,
                                    "last_update": {
                                        "date": null,
                                        "timezone_type": null,
                                        "timezone": null
                                    }
                                }
                            ]
                        }
                    },
                    {
                        "id": 3,
                        "name": "188Bet",
                        "odds": {
                            "data": [
                                {
                                    "label": 1,
                                    "value": "1.02",
                                    "winning": null,
                                    "handicap": null,
                                    "total": null,
                                    "bookmaker_event_id": null,
                                    "last_update": {
                                        "date": null,
                                        "timezone_type": null,
                                        "timezone": null
                                    }
                                },
                                {
                                    "label": "X",
                                    "value": "21.0",
                                    "winning": null,
                                    "handicap": null,
                                    "total": null,
                                    "bookmaker_event_id": null,
                                    "last_update": {
                                        "date": null,
                                        "timezone_type": null,
                                        "timezone": null
                                    }
                                },
                                {
                                    "label": 2,
                                    "value": "41.0",
                                    "winning": null,
                                    "handicap": null,
                                    "total": null,
                                    "bookmaker_event_id": null,
                                    "last_update": {
                                        "date": null,
                                        "timezone_type": null,
                                        "timezone": null
                                    }
                                }
                            ]
                        }
                    },
                    {
                        "id": 23,
                        "name": "UniBet",
                        "odds": {
                            "data": [
                                {
                                    "label": 1,
                                    "value": "1",
                                    "winning": null,
                                    "handicap": null,
                                    "total": null,
                                    "bookmaker_event_id": null,
                                    "last_update": {
                                        "date": null,
                                        "timezone_type": null,
                                        "timezone": null
                                    }
                                },
                                {
                                    "label": "X",
                                    "value": "1001",
                                    "winning": null,
                                    "handicap": null,
                                    "total": null,
                                    "bookmaker_event_id": null,
                                    "last_update": {
                                        "date": null,
                                        "timezone_type": null,
                                        "timezone": null
                                    }
                                },
                                {
                                    "label": 2,
                                    "value": "1",
                                    "winning": null,
                                    "handicap": null,
                                    "total": null,
                                    "bookmaker_event_id": null,
                                    "last_update": {
                                        "date": null,
                                        "timezone_type": null,
                                        "timezone": null
                                    }
                                }
                            ]
                        }
                    },
                    {
                        "id": 28,
                        "name": "BWin",
                        "odds": {
                            "data": [
                                {
                                    "label": 1,
                                    "value": "1",
                                    "winning": null,
                                    "handicap": null,
                                    "total": null,
                                    "bookmaker_event_id": null,
                                    "last_update": {
                                        "date": null,
                                        "timezone_type": null,
                                        "timezone": null
                                    }
                                },
                                {
                                    "label": "X",
                                    "value": "1",
                                    "winning": null,
                                    "handicap": null,
                                    "total": null,
                                    "bookmaker_event_id": null,
                                    "last_update": {
                                        "date": null,
                                        "timezone_type": null,
                                        "timezone": null
                                    }
                                },
                                {
                                    "label": 2,
                                    "value": "1",
                                    "winning": null,
                                    "handicap": null,
                                    "total": null,
                                    "bookmaker_event_id": null,
                                    "last_update": {
                                        "date": null,
                                        "timezone_type": null,
                                        "timezone": null
                                    }
                                }
                            ]
                        }
                    },
                    {
                        "id": 9,
                        "name": "BetFair",
                        "odds": {
                            "data": [
                                {
                                    "label": 1,
                                    "value": "1",
                                    "winning": null,
                                    "handicap": null,
                                    "total": null,
                                    "bookmaker_event_id": null,
                                    "last_update": {
                                        "date": null,
                                        "timezone_type": null,
                                        "timezone": null
                                    }
                                },
...

In-Play Odds#back to top

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

GETGet In-Play Odds

API Reference

URI Parameters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringmatch_oddsinplay
idintegerMATCH_ID

Response

idintegerThe id of the market
namestringThe name of the market
bookmakersobjectid, name, odds
idintegerThe id of the bookmaker
namestringThe name of the bookmaker
oddsobjectlabel, value, american, fractional, suspend, description, handicap, total, bookmaker_event_id, last_update
last_updateobjectdate, timezone_type, timezone

Response Example

{
    "data": [
        {
            "id": 1,
            "name": "1X2, Full Time Result",
            "bookmakers": {
                "data": [
                    {
                        "id": 2,
                        "name": "Bet365",
                        "odds": {
                            "data": [
                                {
                                    "label": 1,
                                    "value": "1.550",
                                    "winning": null,
                                    "handicap": null,
                                    "total": null,
                                    "bookmaker_event_id": null,
                                    "last_update": {
                                        "date": null,
                                        "timezone_type": null,
                                        "timezone": null
                                    }
                                },
                                {
                                    "label": "X",
                                    "value": "4.333",
                                    "winning": null,
                                    "handicap": null,
                                    "total": null,
                                    "bookmaker_event_id": null,
                                    "last_update": {
                                        "date": null,
                                        "timezone_type": null,
                                        "timezone": null
                                    }
                                },
                                {
                                    "label": 2,
                                    "value": "5.500",
                                    "winning": null,
                                    "handicap": null,
                                    "total": null,
                                    "bookmaker_event_id": null,
                                    "last_update": {
                                        "date": null,
                                        "timezone_type": null,
                                        "timezone": null
                                    }
                                }
                            ]
                        }
                    },
                    {
                        "id": 1,
                        "name": "10Bet",
                        "odds": {
                            "data": [
                                {
                                    "label": 1,
                                    "value": "1.541",
                                    "winning": null,
                                    "handicap": null,
                                    "total": null,
                                    "bookmaker_event_id": null,
                                    "last_update": {
                                        "date": null,
                                        "timezone_type": null,
                                        "timezone": null
                                    }
                                },
                                {
                                    "label": "X",
                                    "value": "4.250",
                                    "winning": null,
                                    "handicap": null,
                                    "total": null,
                                    "bookmaker_event_id": null,
                                    "last_update": {
                                        "date": null,
                                        "timezone_type": null,
                                        "timezone": null
                                    }
                                },
                                {
                                    "label": 2,
                                    "value": "5.600",
                                    "winning": null,
                                    "handicap": null,
                                    "total": null,
                                    "bookmaker_event_id": null,
                                    "last_update": {
                                        "date": null,
                                        "timezone_type": null,
                                        "timezone": null
                                    }
                                }
                            ]
                        }
                    },
                    {
                        "id": 32,
                        "name": "Ladbrokes",
                        "odds": {
                            "data": []
                        }
                    },
                    {
                        "id": 37,
                        "name": "WilliamHill",
                        "odds": {
                            "data": []
                        }
                    },
                    {
                        "id": 3,
                        "name": "188Bet",
                        "odds": {
                            "data": [
                                {
                                    "label": 1,
                                    "value": "1.58",
                                    "winning": null,
                                    "handicap": null,
                                    "total": null,
                                    "bookmaker_event_id": null,
                                    "last_update": {
                                        "date": null,
                                        "timezone_type": null,
                                        "timezone": null
                                    }
                                },
                                {
                                    "label": "X",
                                    "value": "4.30",
                                    "winning": null,
                                    "handicap": null,
                                    "total": null,
                                    "bookmaker_event_id": null,
                                    "last_update": {
                                        "date": null,
                                        "timezone_type": null,
                                        "timezone": null
                                    }
                                },
                                {
                                    "label": 2,
                                    "value": "5.40",
                                    "winning": null,
                                    "handicap": null,
                                    "total": null,
                                    "bookmaker_event_id": null,
                                    "last_update": {
                                        "date": null,
                                        "timezone_type": null,
                                        "timezone": null
                                    }
                                }
                            ]
                        }
                    },
                    {
                        "id": 23,
                        "name": "UniBet",
                        "odds": {
                            "data": [
                                {
                                    "label": 1,
                                    "value": "1.58",
                                    "winning": null,
                                    "handicap": null,
                                    "total": null,
                                    "bookmaker_event_id": null,
                                    "last_update": {
                                        "date": null,
                                        "timezone_type": null,
                                        "timezone": null
                                    }
                                },
                                {
                                    "label": "X",
                                    "value": "4.1",
                                    "winning": null,
                                    "handicap": null,
                                    "total": null,
                                    "bookmaker_event_id": null,
                                    "last_update": {
                                        "date": null,
                                        "timezone_type": null,
                                        "timezone": null
                                    }
                                },
                                {
                                    "label": 2,
                                    "value": "5.6",
                                    "winning": null,
                                    "handicap": null,
                                    "total": null,
                                    "bookmaker_event_id": null,
                                    "last_update": {
                                        "date": null,
                                        "timezone_type": null,
                                        "timezone": null
                                    }
                                }
                            ]
                        }
                    },
                    {
                        "id": 28,
                        "name": "BWin",
                        "odds": {
                            "data": [
                                {
                                    "label": 1,
                                    "value": "1.53",
                                    "winning": null,
                                    "handicap": null,
                                    "total": null,
                                    "bookmaker_event_id": null,
                                    "last_update": {
                                        "date": null,
                                        "timezone_type": null,
                                        "timezone": null
                                    }
                                },
                                {
                                    "label": "X",
                                    "value": "4.25",
                                    "winning": null,
                                    "handicap": null,
                                    "total": null,
                                    "bookmaker_event_id": null,
                                    "last_update": {
                                        "date": null,
                                        "timezone_type": null,
                                        "timezone": null
                                    }
                                },
                                {
                                    "label": 2,
                                    "value": "5.5",
                                    "winning": null,
                                    "handicap": null,
                                    "total": null,
                                    "bookmaker_event_id": null,
                                    "last_update": {
                                        "date": null,
                                        "timezone_type": null,
                                        "timezone": null
                                    }
                                }
                            ]
                        }
                    },
                    {
                        "id": 9,
                        "name": "BetFair",
                        "odds": {
                            "data": [
                                {
                                    "label": 1,
                                    "value": "1.5",
                                    "winning": null,
                                    "handicap": null,
                                    "total": null,
                                    "bookmaker_event_id": null,
                                    "last_update": {
                                        "date": null,
                                        "timezone_type": null,
                                        "timezone": null
                                    }
                                },
...

Match Odds by Bookmaker#back to top

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

GETGet Match Odds by Bookmaker

API Reference

URI Parameters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringmatch_odds_info
bookmaker_idintegerBOOKMAKER_ID

Response

idintegerThe id of the market
namestringThe name of the market
bookmakersobjectid, name, odds
idintegerThe id of the bookmaker
namestringThe name of the bookmaker
oddsobjectlabel, value, american, fractional, suspend, description, handicap, total, bookmaker_event_id, last_update
last_updateobjectdate, timezone_type, timezone

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"
                        }
                    },
...

Player by ID#back to top

The Player by ID endpoint returns information of a single player

GETGet player By ID

API Reference

URI Parameters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringinfo
idintegerPLAYER_ID
idintegerThe id of the player
namestringThe name of the player
common_namestringCommon name of the player
firstnamestringFirstname of the player
lastnamestringLastname of the player
positionstringPosition of the player
birthdaystringThe birthday of the player
birthcountrystringThe birthcountry of the player
birthplacestringThe birthplace of the player
weightstringThe weight of the player
heightstringThe height of the player
imgstringThe image of the player
countryobjectid, name, cc
{
    "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"
        }
    },
...
        

Players by Country#back to top

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

GETGet player By ID

API Reference

URI Parameters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringlist
country_idintegerCOUNTRY_ID
idintegerThe id of the player
namestringThe name of the player
common_namestringCommon name of the player
firstnamestringFirstname of the player
lastnamestringLastname of the player
birthdaystringThe birthday of the player
birthcountrystringThe birthcountry of the player
birthplacestringThe birthplace of the player
wstringThe weight of the player
hstringThe height of the player
imgstringThe image of the player
countryobjectid, name, cc
{
    "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"
            }
        },
...

Schedule by Date#back to top

The Schedule Endpoint gives you a list of matches that will be or has been broadcasted on TV or Streaming

GETGet Schedule by Date

API Reference

URI Parameters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringmatch_tvs
idintegerMATCH_ID

Response

id integer The id of the TV Channel
name string The name of the TV Channel
country object id, name, cc (country_code)

Response Example

 
{
    "data": [
        {
            "id": "73226768",
            "status": "3",
            "status_name": "Finished",
            "status_period": null,
            "pitch": null,
            "referee_id": "2399",
            "round_id": "1019",
            "season_id": "1082",
            "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": "2448",
            "leg": null,
            "deleted": "0",
            "time": {
                "datetime": "2020-08-03 11:30:00",
                "date": "2020-08-03",
                "time": "11:30:00",
                "minute": 90,
                "timestamp": 1596447000,
                "timezone": "UTC"
            },
            "teams": {
                "home": {
                    "id": "1100",
                    "name": "Melbourne Victory",
                    "short_code": "MEV",
                    "img": "https://cdn.soccersapi.com/images/soccer/teams/80/1100.png",
                    "form": "4-4-1-1",
                    "coach_id": "5813",
                    "color": null,
                    "kit_colors": null
                },
                "away": {
                    "id": "1099",
                    "name": "Central Coast Mariners FC",
                    "short_code": "CCM",
                    "img": "https://cdn.soccersapi.com/images/soccer/teams/80/1099.png",
                    "form": "4-1-4-1",
                    "coach_id": "1205",
                    "color": null,
                    "kit_colors": null
                }
            },
            "league": {
                "id": "974",
                "name": "A-League",
                "type": "",
                "country_id": "14",
                "country_name": "Australia",
                "country_flag": "https://cdn.soccersapi.com/images/countries/30/au.png"
            },
            "scores": {
                "home_score": "2",
                "away_score": "3",
                "ht_score": "1-0",
                "ft_score": "2-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": "1",
                "has_tvs": "1"
            },
            "weather_report": false
        },
...

Match TV Channels#back to top

The Match TV Channels Endpoint gives you a list of International TV Channels will cover the match

GETGet TV Channels By Match ID

API Reference

URI Parameters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringmatch_tvs
idintegerMATCH_ID

Response

id integer The id of the TV Channel
name string The name of the TV Channel
country object id, name, cc (country_code)

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"
            }
        },
...

Coach by ID#back to top

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

GETGet coaches By ID

API Reference

URI Parameters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringinfo
idintegerCOACH_ID

Response

idintegerThe id of the coach
team_idintegerThe id of the team
namestringThe name of the coach
common_namestringThe common name of the coach
firstnamestringThe firstname of the coach
lastnamestringThe lastname of the coach
birthdaystringThe birthday of the coach
birthcountrystringThe birthcountry of the coach
birthplacestringThe birthplace of the coach
imgstringThe img of the coach
countryobjectid, name, cc

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"
        }
    },
...

Venue by ID#back to top

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

GETGet Venue By ID

API Reference

URI Parameters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringinfo
idintegerVENUE_ID

Response

idintegerThe id of the venue
namestringThe name of the venue
capacitystringThe capacity of the venue
citystringThe city of the venue
addressstringThe address of the venue
imgstringThe img of the venue

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"
        }
    },
...

Referee by ID#back to top

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

GETGet Referee By ID

API Reference

URI Parameters

userstringYOUR_USER
tokenstringYOUR_TOKEN
tstringinfo
idintegerREFEREE_ID

Response

id integer The id of the referee
name string The name of the referee
common_name string Common name of the referee
firstname string Firstname of the referee
lastname string Lastname of the referee

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"
        }
    },

...