Getting fixtures

In this reference we will show you how you can the list of fixtures that we have for all national leagues and how to interpret the data that we give you.


The soccer fixtures api endpoint supports teams names in various languages to find out more about this. Read through our documentation on language support.
In this page, we are explaining how you can get the list with currently available fixtures. The possibilities that you have to filter and traverse the football fixtures data. If you want to see for which leagues currently we do support fixtures, you can read the getting list of leagues with fixtures api documentation.

Endpoint

In order to get the list of all fixtures that our football data feed supports the only thing you need to do is the call the url bellow. Currently, we are supporting fixtures for national leagues 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

GET:


Parameters

The fixtures API endpoint supports several parameters that you can use to filter 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.

NameTypeRequiredExampleDescription
datedateNo2018-05-15Results in showing only fixtures on that date.
leagueintegerNo4Results in showing only fixtures for that league
langstringNofa2 letter ISO 639-1 language code
pageintegerNo2Results in sowing only fixtures on that page with results

Response

A response to a request will contain in total maximum of 30 fixtures for the provided parameters in the query. If you would like to go further in the future you can use the next page like provided by the response. If you would like to go back then you can use the previous page link provided by the response.

NameTypeExampleDescription
datedate2018-05-15the data when the football match is going to be played.
timetime12:00the kick-off time of the football match. If we do not have accurate data you will see only zeros. For example 00:00. All start dates and times are in UTC timezone.
roundinteger/string25/QF the round of the match (a.k.a match day) of the soccer game. If we do not have accurate data you will see 999 as a round number. It could also contain a string representation of the round if it is a direct elimination cup like QF for Quarter-Finals.
home_namestringJuventus FCthe name of the home team in the match.
away_namestringSSC Napolithe name of the away team in the match.
locationstringTorinothe place or stadium where the match is going to be played or empty if we do not have enough data.
league_idinteger5the id of the league to which the match belongs to.
next_pageurl if there are more than 30 matches that satisfy your filtering request you will be able to go to the next page with results following this link. If there is no next page this field will contain false.
prev_pageurlif there are more than 30 matches that satisfy your filtering request and you have traversed into further pages, you will be able to go to the previous page with results following this link. If there is no previous page this field will contain false.
{
    "success": true,
    "data": {
        "fixtures": [
            {
                "date": "2017-10-16",
                "time": "00:30:00",
                "round": "999",
                "home_name": "Santos Laguna",
                "away_name": "Atlas",
                "location": "",
                "league_id": "88"
            },
            {
                "date": "2017-10-16",
                "time": "00:30:00",
                "round": "999",
                "home_name": "O'Higgins",
                "away_name": "Audax Italiano",
                "location": "",
                "league_id": "63"
            },
            {
                "date": "2017-10-16",
                "time": "00:30:00",
                "round": "999",
                "home_name": "Colorado Rapids",
                "away_name": "Real Salt Lake",
                "location": "",
                "league_id": "94"
            }
        ],
        "next_page": "http:\/\/livescore-api.com\/api-client\/fixtures\/matches.json?key=demo_key&secret=demo_secret&page=2",
        "prev_page": false
    }
}


Examples

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

curl -XGET http://livescore-api.com/api-client/fixtures/matches.json?key=demo_key\\&secret=demo_secret
PHP
file_get_contents('http://livescore-api.com/api-client/fixtures/matches.json?key=demo_key\&secret=demo_secret');
Python
import urllib2
req = urllib2.Request('http://livescore-api.com/api-client/fixtures/matches.json?key=demo_key\&secret=demo_secret')
response = urllib2.urlopen(req)
print response.read()