Getting past matches beta

On this page you can find the way to use our historical API endpoints. Get the information about past matches that have ended.

The football history api endpoint supports teams names in various languages to find out more about this. Read through our documentation on language support.
On this page, we are explaining how you can get the list with football matches and scores that have been played back time for which there is available information. The possibilities that you have to filter and traverse our historical football data.


In order to get the list of all historical football matches data from our api the only thing you need to do is the call the url bellow. We are supporting historical data for national leagues, cup matches, international leagues from all over the globe. In this example, we have used the demo api key and secret pair. If you login in, you will see all examples with your own api key and api secret



The history API endpoint supports several parameters that you can use to filter the football data and traverse through it at your convenience. The parameters are listed in the table below. You can use the parameters together as well as separately.

fromdateNo2018-05-15Get past matches from this date onwards.
todateNo2018-05-15Get past matches data until this date included.
leagueintegerNo8Get past matches data for a certain league with the provided id
teamintegerNo19The id of the team which past scores you need
pageintegerNo3If there are pages you can go to a specific page using this parameter
langstringNoru2 letter ISO 639-1 language code


A response to a request will contain in total maximum of 30 past matches data for the provided parameters in the query.

idinteger78the id of the match it is the same as the id of the match when it was available in our livescore endpoints. This ID differs from the fixture id.
home_nameintegerReal Madrid FCthe name of the home side team
away_nameintegerFC Barcelonathe name of the away side team
ht_scorestring0 - 0the score of the match when half time was reached
ft_scorestring1 - 1the score of the match when 90 minutes were reached
et_scorestring1 - 2 the score of the match after 120 minutes of extra time
timestringFTthe time in minutes. It should always be FT
league_idinteger5the id of the league to which the game belonged
statusstringFINISHEDthe status of the match it should always be FINISHED
addeddatetime2018-03-23 14:27:02the date and time when the soccer match was added to our livescore api data endpoint
last_changeddatetime2018-03-23 14:27:02 the date and time when the last modification of the match records was made
home_idinteger18the id of the home team, 0 if not availalbe
away_idinteger19the id of the away team, 0 if not available
    "success": true,
    "data": {
        "match": [
                "id": "1",
                "date": "2017-01-13",
                "home_name": "Vaalerenga",
                "away_name": "Asker",
                "score": "1 - 0",
                "ht_score": "0 - 0",
                "ft_score": "",
                "et_score": "1 - 0",
                "time": "FT",
                "league_id": "5",
                "status": "FINISHED",
                "added": "2017-01-13 11:56:01",
                "last_changed": "2017-01-13 13:21:02",
                "home_id": "0",
                "away_id": "0"
                "id": "2",
                "date": "2017-01-13",
                "home_name": "Al Hilal",
                "away_name": "FC Rostov",
                "score": "0 - 4",
                "ht_score": "0 - 1",
                "ft_score": "",
                "et_score": "0 - 4",
                "time": "FT",
                "league_id": "5",
                "status": "FINISHED",
                "added": "2017-01-13 11:56:01",
                "last_changed": "2017-01-13 13:53:06",
                "home_id": "0",
                "away_id": "0"


The following examples show you how to use this endpoint in various programming languages without any filters provided. In this example, we have used the demo api key and secret pair. If you login in, you will see all examples with your own api key and api secret


curl -XGET\\&secret=demo_secret
import urllib2
req = urllib2.Request('\&secret=demo_secret')
response = urllib2.urlopen(req)