Soccer API Tech Docs

Soccer API Recent Match List

Provides the result list of the last 20 matches between the two teams in overall, with home and away filters.

Soccer Recent Match List Request URL

GET

References / Dependencies

Tournament ID The id of the tournament. You can find list of tournament from Tournament List endpoint

Stage / Round Structure Stage / Round structures change tournament by tournament. You can find the structures with Tournament Id from Tournament Info endpoint

Teams Informations The informations of teams in the tournament. You can find list of the teams from Tournament Teams endpoint

Call Rate / Interval

Recommended API Call Interval: Daily Max API Call:

Request Headers

Data	Type	O / R	Example	Description
languageId	INT	R	{languageId}	The id of the language that you select.
Ocp-Apim-Subscription-Key	STR	R	{yourOcp-Apim-Subscription-Key}	Your account key.
Accept	STR	O	application/xml	Selection of data presentation type as XML/JSON.

^*O= Optional, R= Required

Request Parameters

Data	Type	O / R	Example	Description
matchId	INT	R	{matchId}	The id of the match.

Response Output

{ "homeTeam": { "name": "Liverpool", "shortName": "LIV", "mediumName": "Liverpool", "id": 265 }, "awayTeam": { "name": "West Ham United", "shortName": "WHU", "mediumName": "West Ham", "id": 381 }, "status": { "name": "Scheduled", "shortName": "SCH", "id": 1 }, "h2h": { "results": { "overall": [ { "homeTeam": { "score": { "regular": 3, "halfTime": 3, "current": 3 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "awayTeam": { "score": { "regular": 0, "halfTime": 0, "current": 0 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "20/11/2010 16:30:00", "id": 224874, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "Season 2010/2011", "shortName": "", "id": 7921 } }, { "homeTeam": { "score": { "regular": 3, "halfTime": 2, "current": 3 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "awayTeam": { "score": { "regular": 1, "halfTime": 0, "current": 1 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "27/02/2011 12:30:00", "id": 225015, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "Season 2010/2011", "shortName": "", "id": 7921 } }, { "homeTeam": { "score": { "regular": 2, "halfTime": 2, "current": 2 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "awayTeam": { "score": { "regular": 3, "halfTime": 1, "current": 3 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "09/12/2012 15:00:00", "id": 714729, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "Season 2012/2013", "shortName": "", "id": 17715 } }, { "homeTeam": { "score": { "regular": 0, "halfTime": 0, "current": 0 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "awayTeam": { "score": { "regular": 0, "halfTime": 0, "current": 0 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "07/04/2013 12:30:00", "id": 714882, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "Season 2012/2013", "shortName": "", "id": 17715 } }, { "homeTeam": { "score": { "regular": 4, "halfTime": 1, "current": 4 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "awayTeam": { "score": { "regular": 1, "halfTime": 0, "current": 1 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "07/12/2013 14:00:00", "id": 779832, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "Season 2013/2014", "shortName": "", "id": 20241 } }, { "homeTeam": { "score": { "regular": 1, "halfTime": 1, "current": 1 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "awayTeam": { "score": { "regular": 2, "halfTime": 1, "current": 2 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "06/04/2014 15:00:00", "id": 780018, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "Season 2013/2014", "shortName": "", "id": 20241 } }, { "homeTeam": { "score": { "regular": 3, "halfTime": 2, "current": 3 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "awayTeam": { "score": { "regular": 1, "halfTime": 1, "current": 1 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "20/09/2014 16:30:00", "id": 963594, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "Season 2014/2015", "shortName": "14/15", "id": 26394 } }, { "homeTeam": { "score": { "regular": 2, "halfTime": 0, "current": 2 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "awayTeam": { "score": { "regular": 0, "halfTime": 0, "current": 0 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "31/01/2015 14:00:00", "id": 963769, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "Season 2014/2015", "shortName": "14/15", "id": 26394 } }, { "homeTeam": { "score": { "regular": 0, "halfTime": 0, "current": 0 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "awayTeam": { "score": { "regular": 3, "halfTime": 2, "current": 3 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "29/08/2015 14:00:00", "id": 1048660, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "2015/2016 Season", "shortName": "15/16", "id": 29810 } }, { "homeTeam": { "score": { "regular": 2, "halfTime": 1, "current": 2 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "awayTeam": { "score": { "regular": 0, "halfTime": 0, "current": 0 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "02/01/2016 11:45:00", "id": 1048826, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "2015/2016 Season", "shortName": "15/16", "id": 29810 } }, { "homeTeam": { "score": { "regular": 0, "halfTime": 0, "current": 0 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "awayTeam": { "score": { "regular": 0, "halfTime": 0, "current": 0 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "30/01/2016 16:30:00", "id": 1154223, "tournament": { "name": "FA Cup", "shortName": "FAC", "id": 45 }, "stage": { "name": "4th round", "shortName": "TR 4", "id": 32026 } }, { "homeTeam": { "score": { "regular": 1, "halfTime": 1, "extraTime": 2, "current": 2 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "awayTeam": { "score": { "regular": 1, "halfTime": 0, "extraTime": 1, "current": 1 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "status": { "name": "Finished A.E.T.", "shortName": "AET", "id": 9 }, "date": "09/02/2016 18:45:00", "id": 1156702, "tournament": { "name": "FA Cup", "shortName": "FAC", "id": 45 }, "stage": { "name": "4th round", "shortName": "TR 4", "id": 32026 } }, { "homeTeam": { "score": { "regular": 2, "halfTime": 1, "current": 2 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "awayTeam": { "score": { "regular": 2, "halfTime": 2, "current": 2 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "11/12/2016 16:30:00", "id": 1170968, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "2016/2017 Season", "shortName": "18/19", "id": 32630 } }, { "homeTeam": { "score": { "regular": 0, "halfTime": 0, "current": 0 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "awayTeam": { "score": { "regular": 4, "halfTime": 1, "current": 4 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "14/05/2017 13:15:00", "id": 1171192, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "2016/2017 Season", "shortName": "18/19", "id": 32630 } }, { "homeTeam": { "score": { "regular": 1, "halfTime": 0, "current": 1 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "awayTeam": { "score": { "regular": 4, "halfTime": 2, "current": 4 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "04/11/2017 17:30:00", "id": 1242198, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "2017/2018 Season", "shortName": "18/19", "id": 35021 } }, { "homeTeam": { "score": { "regular": 4, "halfTime": 1, "current": 4 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "awayTeam": { "score": { "regular": 1, "halfTime": 0, "current": 1 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "24/02/2018 15:00:00", "id": 1242365, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "2017/2018 Season", "shortName": "18/19", "id": 35021 } }, { "homeTeam": { "score": { "regular": 4, "halfTime": 2, "current": 4 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "awayTeam": { "score": { "regular": 0, "halfTime": 0, "current": 0 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "12/08/2018 12:30:00", "id": 1307427, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "2018/2019 Season", "shortName": "18/19", "id": 37295 } }, { "homeTeam": { "score": { "regular": 1, "halfTime": 1, "current": 1 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "awayTeam": { "score": { "regular": 1, "halfTime": 1, "current": 1 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "04/02/2019 20:00:00", "id": 1307671, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "2018/2019 Season", "shortName": "18/19", "id": 37295 } }, { "homeTeam": { "score": { "regular": 0, "halfTime": 0, "current": 0 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "awayTeam": { "score": { "regular": 2, "halfTime": 1, "current": 2 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "29/01/2020 19:45:00", "id": 1370207, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "Season 2019/2020", "shortName": "19/20", "id": 39617 } }, { "homeTeam": { "score": { "regular": 3, "halfTime": 1, "current": 3 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "awayTeam": { "score": { "regular": 2, "halfTime": 1, "current": 2 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "24/02/2020 20:00:00", "id": 1370293, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "Season 2019/2020", "shortName": "19/20", "id": 39617 } } ], "home": [ { "homeTeam": { "score": { "regular": 0, "halfTime": 0, "current": 0 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "awayTeam": { "score": { "regular": 0, "halfTime": 0, "current": 0 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "30/11/2008 21:00:00", "id": 210, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "Regular Season", "shortName": "", "id": 42 } }, { "homeTeam": { "score": { "regular": 4, "halfTime": 1, "current": 4 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "awayTeam": { "score": { "regular": 0, "halfTime": 0, "current": 0 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "04/03/2008 21:00:00", "id": 6371, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "Regular Season", "shortName": "", "id": 143 } }, { "homeTeam": { "score": { "regular": 2, "halfTime": 2, "current": 2 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "awayTeam": { "score": { "regular": 1, "halfTime": 1, "current": 1 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "25/08/2006 21:00:00", "id": 18358, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "Regular Season", "shortName": "", "id": 142 } }, { "homeTeam": { "score": { "regular": 2, "halfTime": 1, "current": 2 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "awayTeam": { "score": { "regular": 0, "halfTime": 0, "current": 0 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "28/10/2005 21:00:00", "id": 29072, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "Regular Season", "shortName": "", "id": 141 } }, { "homeTeam": { "score": { "regular": 2, "halfTime": 1, "extraTime": 3, "current": 3 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "awayTeam": { "score": { "regular": 3, "halfTime": 2, "extraTime": 3, "current": 3 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "status": { "name": "Finished A.E.T.", "shortName": "AET", "id": 9 }, "date": "12/05/2006 21:00:00", "id": 44493, "tournament": { "name": "FA Cup", "shortName": "FAC", "id": 45 }, "stage": { "name": "Final", "shortName": "", "id": 1361 } }, { "homeTeam": { "score": { "regular": 2, "halfTime": 1, "current": 2 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "awayTeam": { "score": { "regular": 0, "halfTime": 0, "current": 0 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "01/11/2002 21:00:00", "id": 48500, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "Regular Season", "shortName": "", "id": 138 } }, { "homeTeam": { "score": { "regular": 2, "halfTime": 1, "current": 2 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "awayTeam": { "score": { "regular": 1, "halfTime": 1, "current": 1 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "17/08/2001 21:00:00", "id": 48974, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "Regular Season", "shortName": "", "id": 137 } }, { "homeTeam": { "score": { "regular": 3, "halfTime": 2, "current": 3 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "awayTeam": { "score": { "regular": 0, "halfTime": 0, "current": 0 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "02/02/2001 21:00:00", "id": 50963, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "Regular Season", "shortName": "", "id": 136 } }, { "homeTeam": { "score": { "regular": 1, "halfTime": 1, "current": 1 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "awayTeam": { "score": { "regular": 0, "halfTime": 0, "current": 0 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "26/10/1999 21:00:00", "id": 51645, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "Regular Season", "shortName": "", "id": 135 } }, { "homeTeam": { "score": { "regular": 3, "halfTime": 2, "current": 3 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "awayTeam": { "score": { "regular": 0, "halfTime": 0, "current": 0 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "19/04/2010 19:00:00", "id": 110767, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "Regular Season", "shortName": "", "id": 97 } }, { "homeTeam": { "score": { "regular": 3, "halfTime": 3, "current": 3 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "awayTeam": { "score": { "regular": 0, "halfTime": 0, "current": 0 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "20/11/2010 16:30:00", "id": 224874, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "Season 2010/2011", "shortName": "", "id": 7921 } }, { "homeTeam": { "score": { "regular": 0, "halfTime": 0, "current": 0 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "awayTeam": { "score": { "regular": 0, "halfTime": 0, "current": 0 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "07/04/2013 12:30:00", "id": 714882, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "Season 2012/2013", "shortName": "", "id": 17715 } }, { "homeTeam": { "score": { "regular": 4, "halfTime": 1, "current": 4 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "awayTeam": { "score": { "regular": 1, "halfTime": 0, "current": 1 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "07/12/2013 14:00:00", "id": 779832, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "Season 2013/2014", "shortName": "", "id": 20241 } }, { "homeTeam": { "score": { "regular": 2, "halfTime": 0, "current": 2 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "awayTeam": { "score": { "regular": 0, "halfTime": 0, "current": 0 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "31/01/2015 14:00:00", "id": 963769, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "Season 2014/2015", "shortName": "14/15", "id": 26394 } }, { "homeTeam": { "score": { "regular": 0, "halfTime": 0, "current": 0 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "awayTeam": { "score": { "regular": 3, "halfTime": 2, "current": 3 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date":
"29/08/2015 14:00:00", "id": 1048660, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "2015/2016 Season", "shortName": "15/16", "id": 29810 } }, { "homeTeam": { "score": { "regular": 0, "halfTime": 0, "current": 0 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "awayTeam": { "score": { "regular": 0, "halfTime": 0, "current": 0 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "30/01/2016 16:30:00", "id": 1154223, "tournament": { "name": "FA Cup", "shortName": "FAC", "id": 45 }, "stage": { "name": "4th round", "shortName": "TR 4", "id": 32026 } }, { "homeTeam": { "score": { "regular": 2, "halfTime": 1, "current": 2 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "awayTeam": { "score": { "regular": 2, "halfTime": 2, "current": 2 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "11/12/2016 16:30:00", "id": 1170968, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "2016/2017 Season", "shortName": "18/19", "id": 32630 } }, { "homeTeam": { "score": { "regular": 4, "halfTime": 1, "current": 4 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "awayTeam": { "score": { "regular": 1, "halfTime": 0, "current": 1 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "24/02/2018 15:00:00", "id": 1242365, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "2017/2018 Season", "shortName": "18/19", "id": 35021 } }, { "homeTeam": { "score": { "regular": 4, "halfTime": 2, "current": 4 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "awayTeam": { "score": { "regular": 0, "halfTime": 0, "current": 0 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "12/08/2018 12:30:00", "id": 1307427, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "2018/2019 Season", "shortName": "18/19", "id": 37295 } }, { "homeTeam": { "score": { "regular": 3, "halfTime": 1, "current": 3 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "awayTeam": { "score": { "regular": 2, "halfTime": 1, "current": 2 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "24/02/2020 20:00:00", "id": 1370293, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "Season 2019/2020", "shortName": "19/20", "id": 39617 } } ], "away": [ { "homeTeam": { "score": { "regular": 0, "halfTime": 0, "current": 0 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "awayTeam": { "score": { "regular": 3, "halfTime": 2, "current": 3 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "08/05/2009 21:00:00", "id": 549, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "Regular Season", "shortName": "", "id": 42 } }, { "homeTeam": { "score": { "regular": 1, "halfTime": 0, "current": 1 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "awayTeam": { "score": { "regular": 0, "halfTime": 0, "current": 0 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "29/01/2008 21:00:00", "id": 6311, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "Regular Season", "shortName": "", "id": 143 } }, { "homeTeam": { "score": { "regular": 1, "halfTime": 0, "current": 1 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "awayTeam": { "score": { "regular": 2, "halfTime": 0, "current": 2 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "29/01/2007 21:00:00", "id": 18926, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "Regular Season", "shortName": "", "id": 142 } }, { "homeTeam": { "score": { "regular": 1, "halfTime": 0, "current": 1 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "awayTeam": { "score": { "regular": 2, "halfTime": 1, "current": 2 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "25/04/2006 21:00:00", "id": 29556, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "Regular Season", "shortName": "", "id": 141 } }, { "homeTeam": { "score": { "regular": 0, "halfTime": 0, "current": 0 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "awayTeam": { "score": { "regular": 3, "halfTime": 2, "current": 3 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "01/02/2003 21:00:00", "id": 48749, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "Regular Season", "shortName": "", "id": 138 } }, { "homeTeam": { "score": { "regular": 1, "halfTime": 1, "current": 1 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "awayTeam": { "score": { "regular": 1, "halfTime": 1, "current": 1 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "28/12/2001 21:00:00", "id": 49463, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "Regular Season", "shortName": "", "id": 137 } }, { "homeTeam": { "score": { "regular": 1, "halfTime": 0, "current": 1 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "awayTeam": { "score": { "regular": 1, "halfTime": 1, "current": 1 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "16/09/2000 21:00:00", "id": 50143, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "Regular Season", "shortName": "", "id": 136 } }, { "homeTeam": { "score": { "regular": 1, "halfTime": 1, "current": 1 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "awayTeam": { "score": { "regular": 0, "halfTime": 0, "current": 0 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "26/11/1999 21:00:00", "id": 51754, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "Regular Season", "shortName": "", "id": 135 } }, { "homeTeam": { "score": { "regular": 2, "halfTime": 2, "current": 2 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "awayTeam": { "score": { "regular": 3, "halfTime": 2, "current": 3 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "19/09/2009 16:30:00", "id": 110413, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "Regular Season", "shortName": "", "id": 97 } }, { "homeTeam": { "score": { "regular": 3, "halfTime": 2, "current": 3 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "awayTeam": { "score": { "regular": 1, "halfTime": 0, "current": 1 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "27/02/2011 12:30:00", "id": 225015, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "Season 2010/2011", "shortName": "", "id": 7921 } }, { "homeTeam": { "score": { "regular": 2, "halfTime": 1, "current": 2 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "awayTeam": { "score": { "regular": 1, "halfTime": 0, "current": 1 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "12/09/1998 15:00:00", "id": 237538, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "Regular Season", "shortName": "", "id": 132 } }, { "homeTeam": { "score": { "regular": 2, "halfTime": 2, "current": 2 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "awayTeam": { "score": { "regular": 3, "halfTime": 1, "current": 3 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "09/12/2012 15:00:00", "id": 714729, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "Season 2012/2013", "shortName": "", "id": 17715 } }, { "homeTeam": { "score": { "regular": 1, "halfTime": 1, "current": 1 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "awayTeam": { "score": { "regular": 2, "halfTime": 1, "current": 2 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "06/04/2014 15:00:00", "id": 780018, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "Season 2013/2014", "shortName": "", "id": 20241 } }, { "homeTeam": { "score": { "regular": 3, "halfTime": 2, "current": 3 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "awayTeam": { "score": { "regular": 1, "halfTime": 1, "current": 1 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "20/09/2014 16:30:00", "id": 963594, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "Season 2014/2015", "shortName": "14/15", "id": 26394 } }, { "homeTeam": { "score": { "regular": 2, "halfTime": 1, "current": 2 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "awayTeam": { "score": { "regular": 0, "halfTime": 0, "current": 0 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "02/01/2016 11:45:00", "id": 1048826, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "2015/2016 Season", "shortName": "15/16", "id": 29810 } }, { "homeTeam": { "score": { "regular": 1, "halfTime": 1, "extraTime": 2, "current": 2 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "awayTeam": { "score": { "regular": 1, "halfTime": 0, "extraTime": 1, "current": 1 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "status": { "name": "Finished A.E.T.", "shortName": "AET", "id": 9 }, "date": "09/02/2016 18:45:00", "id": 1156702, "tournament": { "name": "FA Cup", "shortName": "FAC", "id": 45 }, "stage": { "name": "4th round", "shortName": "TR 4", "id": 32026 } }, { "homeTeam": { "score": { "regular": 0, "halfTime": 0, "current": 0 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "awayTeam": { "score": { "regular": 4, "halfTime": 1, "current": 4 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "14/05/2017 13:15:00", "id": 1171192, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "2016/2017 Season", "shortName": "18/19", "id": 32630 } }, { "homeTeam": { "score": { "regular": 1, "halfTime": 0, "current": 1 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "awayTeam": { "score": { "regular": 4, "halfTime": 2, "current": 4 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "04/11/2017 17:30:00", "id": 1242198, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "2017/2018 Season", "shortName": "18/19", "id": 35021 } }, { "homeTeam": { "score": { "regular": 1, "halfTime": 1, "current": 1 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "awayTeam": { "score": { "regular": 1, "halfTime": 1, "current": 1 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "04/02/2019 20:00:00", "id": 1307671, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "2018/2019 Season", "shortName": "18/19", "id": 37295 } }, { "homeTeam": { "score": { "regular": 0, "halfTime": 0, "current": 0 }, "name": "West Ham United", "shortName": "WHU", "id": 381 }, "awayTeam": { "score": { "regular": 2, "halfTime": 1, "current": 2 }, "name": "Liverpool", "shortName": "LIV", "id": 265 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "29/01/2020 19:45:00", "id": 1370207, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "Season 2019/2020", "shortName": "19/20", "id": 39617 } } ] } }, "date": "31/10/2020 17:30:00", "id": 1456414, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "Season 2020/2021", "shortName": "20/21", "id": 42532 }, "round": { "name": "Round 7", "shortName": "W7", "id": 7 } }

Response Output Definitions

match

Data

Type

Example

Description

INT

1456414

The id of the match

date

DATE/STR

31/10/2020 17:30:00

The kick-off date of the match, also includes the time

tournament

Data	Type	Example	Description
name	STR	English Premier League	The full name of the tournament
shortName	STR	EPL	The short name of the tournament
id	INT	2	The id of the tournament

homeTeam/awayTeam

Data	Type	Example	Description
name	STR	West Ham United	The full name of the homeTeam/awayTeam
shortName	STR	WHU	The short name of the homeTeam/awayTeam
mediumName	STR	West Ham	The medium name of the homeTeam/awayTeam
id	INT	381	The id of the homeTeam/awayTeam

status

Data	Type	Example	Description
name	STR	Scheduled	The name of the status
shortName	STR	SCH	The short name of the status
id	INT	1	The id of the status

h2h

results

overall/home/away

homeTeam/awayTeam

Data

Type

Example

Description

name

STR

Liverpool

The full name of the homeTeam/awayTeam

shortName

STR

LIV

The short name of the homeTeam/awayTeam

INT

265

The id of the homeTeam/awayTeam

score

Data	Type	Example	Description
regular	INT	3	The regular score of the match for home/away team
halfTime	INT	3	The half-time score of the match for home/away team
current	INT	3	The current score of the match for home/away team
penalties	INT	5	The penalties score of the match for home/away team
extraTime	INT	2	The extraTime score of the match for home/away team

status

Data	Type	Example	Description
name	STR	Full Time	The name of the status
shortName	STR	FT	The short name of the status
id	INT	5	The id of the status

tournament

Data	Type	Example	Description
name	STR	English Premier League	The name of the tournament
shortName	STR	EPL	The short name of the tournament
id	INT	2	The id of the tournament

stage

Data	Type	Example	Description
name	STR	Season 2010/2011	The name of the stage
shortName	STR	10/11	The short name of the stsage
id	INT	7921	The id of the stage

stage

Data	Type	Example	Description
name	STR	Season 2020/2021	The name of the stage
shortName	STR	20/21	The short name of the stage
id	INT	42532	The id of the stage

round

Data	Type	Example	Description
name	STR	Round 7	The name of the round
shortName	STR	W7	The short name of the round
id	INT	7	The id of the round

Soccer API Tech Docs

Tech Docs Index

Documentation

Widgets

Lookups

Global API

Soccer API

Basketball API

Football API

Baseball API

Ice Hockey API

Volleyball API

Handball API

Soccer API Recent Match List

Soccer Recent Match List Request URL

References / Dependencies

Call Rate / Interval

Request Headers

Request Parameters

Response Output

Response Output Definitions

match

tournament

homeTeam/awayTeam

status

h2h

results

overall/home/away

homeTeam/awayTeam

score

status

tournament

stage

stage

round