Calendar fixtures

  1. Endpoint
  2. Parameters
  3. Response
  4. Examples

In this reference page, we show you how you can the list of fixtures that we have for all competitions and how to interpret the data that our football API provides you.

This football API endpoint supports filtering by league, but they are now deprecated to get optimal results, please switch to using competitions instead. You can find more about competitions on the football competitions documentation page.

The fixtures football 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 currently available fixtures. Also, the possibilities that you have to filter and traverse the football fixtures data.


NOTE: The id of the fixture will not be the id of the match when the match starts or finishes, but there is a filed in the data provided by the live scores api endpoint that is called fixture_id, which indicates to which fixture the match is related to. The same thing applies for the football history matches api endpoint. There you can also find the data field fixture_id and the id of the live-score match ID and the history match ID is always the same.


ENDPOINT


In order, to get the list of all fixtures that our football API feed supports the only thing you need to do is the call the URL below. We are supporting fixtures for 400+ national and international competitions all over the globe. In this example, we have used your api key and secret pair. If you copy the URL it will work straight away.


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
competition_idnumber16the id of the competition in which the match will take place
datedate/string2018-05-15/todayResults in showing only fixtures on that date. If you provide today as a value, our football API will return only the fixtures for today.
langstringfa2 letter ISO 639-1 language code
pagenumber2Results in sowing only fixtures on that page with results
roundnumber/string19/R16Filters the fixtures by the a specific round if the league supports one. It could be a number like 1, 5 or 10, and if could also be R16, QF, SF and similar
teamnumber19Filters the fixtures by the a specific team

Our football API now transitioned to using competitions and leagues are deprecated. If your code uses leagues it will continue to work but for new users, only the competition filtering will be functioning.


RESPONSE


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


NameTypeExampleDescription
away_idnumber2090the team id of the visiting team
away_namestringSSC Napolithe name of the away team in the match.
away_translationsobjectcontains all possible away team names translations. For bigger competitions like the FIFA World Cup we support many more languages. For more information visit our football api languages documentation
competition.idnumber26the id of the competition in which the match takes place
competition.namestringSuper LeagueThe name of the competition in which the match is taking place
competition_idnumber26the id of the competition in which the match takes place
datedate2018-05-15the data when the football match is going to be played.
group_idnumber1714the id of the group in which the fixture is part of. This is very useful for big competitions like the FIFA World Cup or the CONMEBOL Copa America
h2hstring,booleanhttp://....The API endpoint that can be used to compare the 2 teams using our head 2 head football api endpoint
home_Idnumber2089the team id of the home team
home_namestringJuventus FCthe name of the home team in the match.
home_translationsobjectcontains all possible home team names translations. For bigger competitions like the FIFA World Cup we support many more languages. For more information visit our football api languages documentation
idnumber1578384The id of the fixture. It is permanent and allows you to follow the fixture around if it is moved by the football association responsible for the competition in which the fixture takes place in
league_idinteger5the id of the league to which the match belongs to.
locationstringTorinothe place or stadium where the match is going to be played or empty if we do not have enough data.
next_pageurlif 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.
odds.pre.1number2.20The odds of the home team winning before the start of the match
odds.pre.2number2.50The odds of the away team winning before the start of the match
odds.pre.Xnumber4.00The odds of a draw before the start of the match
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.
roundinteger/string25/QFthe round of the match (a.k.a matchday) of the football 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. For example, QF for Quarter-Finals.
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 the UTC timezone.

{
    "success": true,
    "data": {
        "fixtures": [
            {
                "competition": {
                    "name": "FIFA World Cup",
                    "id": 362
                },
                "home_id": 1427,
                "home_name": "Qatar",
                "id": 1527773,
                "location": "Al Bayt Stadium, Al Khor",
                "round": "1",
                "group_id": 1913,
                "date": "2022-11-20",
                "away_id": 1847,
                "league": {
                    "name": null,
                    "country_id": null,
                    "id": null
                },
                "league_id": 0,
                "home_translations": {
                    "nl": "Qatar",
                    "no": "Qatar",
                    "ro": "Qatar",
                    "ka": "\u10e7\u10d0\u10e2\u10d0\u10e0\u10d8",
                    "ko": "\uce74\ud0c0\ub974",
                    "ar": "\u0642\u0637\u0631",
                    "fr": "Qatar",
                    "el": "\u039a\u03b1\u03c4\u03ac\u03c1",
                    "tr": "Katar",
                    "da": "Qatar",
                    "sk": "Katar",
                    "sr": "\u041a\u0430\u0442\u0430\u0440",
                    "zh": "\u5361\u5854\u5c14",
                    "sv": "Qatar",
                    "et": "Katar",
                    "bg": "\u041a\u0430\u0442\u0430\u0440",
                    "cs": "Katar",
                    "de": "Katar",
                    "hr": "Katar",
                    "th": "\u0e01\u0e32\u0e15\u0e32\u0e23\u0e4c",
                    "hu": "Katar",
                    "es": "Catar",
                    "pl": "Katar",
                    "fa": "\u0642\u0637\u0631",
                    "vi": "Qatar",
                    "ru": "\u041a\u0430\u0442\u0430\u0440",
                    "ja": "\u30ab\u30bf\u30fc\u30eb",
                    "it": "Qatar",
                    "pt": "Catar",
                    "lt": "Kataras",
                    "fi": "Qatar"
                },
                "odds": {
                    "live": {
                        "2": null,
                        "1": null,
                        "X": null
                    },
                    "pre": {
                        "2": 2.05,
                        "1": 3.8,
                        "X": 3.45
                    }
                },
                "competition_id": 362,
                "time": "16:00:00",
                "away_name": "Ecuador",
                "away_translations": {
                    "nl": "Ecuador",
                    "no": "Ecuador",
                    "ro": "Ecuador",
                    "ka": "\u10d4\u10d9\u10d5\u10d0\u10d3\u10dd\u10e0\u10d8",
                    "ko": "\uc5d0\ucf70\ub3c4\ub974",
                    "ar": "\u0627\u0644\u0625\u0643\u0648\u0627\u062f\u0648\u0631",
                    "fr": "\u00c9quateur (pays)",
                    "el": "\u0399\u03c3\u03b7\u03bc\u03b5\u03c1\u03b9\u03bd\u03cc\u03c2",
                    "tr": "Ekvador",
                    "da": "Ecuador",
                    "sk": "Ekv\u00e1dor",
                    "sr": "\u0415\u043a\u0432\u0430\u0434\u043e\u0440",
                    "zh": "\u5384\u74dc\u591a\u5c14",
                    "sv": "Ecuador",
                    "et": "Ecuador",
                    "bg": "\u0415\u043a\u0432\u0430\u0434\u043e\u0440",
                    "cs": "Ekv\u00e1dor",
                    "de": "Ecuador",
                    "hr": "Ekvador",
                    "th": "\u0e40\u0e2d\u0e01\u0e27\u0e32\u0e14\u0e2d\u0e23\u0e4c",
                    "hu": "Ecuador",
                    "es": "Ecuador",
                    "pl": "Ekwador",
                    "fa": "\u0627\u06a9\u0648\u0627\u062f\u0648\u0631",
                    "vi": "Ecuador",
                    "ru": "\u042d\u043a\u0432\u0430\u0434\u043e\u0440",
                    "ja": "\u30a8\u30af\u30a2\u30c9\u30eb",
                    "it": "Ecuador",
                    "pt": "Equador",
                    "lt": "Ekvadoras",
                    "fi": "Ecuador"
                },
                "h2h": "https:\/\/livescore-api.com\/api-client\/teams\/head2head.json?key=demo_key&secret=demo_secret&team1_id=1427&team2_id=1847"
            },
            {
                "competition": {
                    "name": "FIFA World Cup",
                    "id": 362
                },
                "home_id": 1460,
                "home_name": "Senegal",
                "id": 1527774,
                "location": "Al Thumama Stadium, Doha",
                "round": "1",
                "group_id": 1913,
                "date": "2022-11-21",
                "away_id": 1649,
                "league": {
                    "name": null,
                    "country_id": null,
                    "id": null
                },
                "league_id": 0,
                "home_translations": {
                    "nl": "Senegal",
                    "no": "Senegal",
                    "ro": "Senegal",
                    "ka": "\u10e1\u10d4\u10dc\u10d4\u10d2\u10d0\u10da\u10d8",
                    "ko": "\uc138\ub124\uac08",
                    "ar": "\u0627\u0644\u0633\u0646\u063a\u0627\u0644",
                    "fr": "S\u00e9n\u00e9gal",
                    "el": "\u03a3\u03b5\u03bd\u03b5\u03b3\u03ac\u03bb\u03b7",
                    "tr": "Senegal",
                    "da": "Senegal",
                    "sk": "Senegal",
                    "sr": "\u0421\u0435\u043d\u0435\u0433\u0430\u043b",
                    "zh": "\u585e\u5185\u52a0\u5c14",
                    "sv": "Senegal",
                    "et": "Senegal",
                    "bg": "\u0421\u0435\u043d\u0435\u0433\u0430\u043b",
                    "cs": "Senegal",
                    "de": "Senegal",
                    "hr": "Senegal",
                    "th": "\u0e40\u0e0b\u0e40\u0e19\u0e01\u0e31\u0e25",
                    "hu": "Szeneg\u00e1l",
                    "es": "Senegal",
                    "pl": "Senegal",
                    "fa": "\u0633\u0646\u06af\u0627\u0644",
                    "vi": "S\u00e9n\u00e9gal",
                    "ru": "\u0421\u0435\u043d\u0435\u0433\u0430\u043b",
                    "ja": "\u30bb\u30cd\u30ac\u30eb",
                    "it": "Senegal",
                    "pt": "Senegal",
                    "lt": "Senegalas",
                    "fi": "Senegal"
                },
                "odds": {
                    "live": {
                        "2": null,
                        "1": null,
                        "X": null
                    },
                    "pre": {
                        "2": 1.62,
                        "1": 5.75,
                        "X": 3.85
                    }
                },
                "competition_id": 362,
                "time": "10:00:00",
                "away_name": "Netherlands",
                "away_translations": {
                    "nl": "Nederland",
                    "no": "Nederland",
                    "ro": "\u021a\u0103rile de Jos",
                    "ka": "\u10dc\u10d8\u10d3\u10d4\u10e0\u10da\u10d0\u10dc\u10d3\u10d4\u10d1\u10d8",
                    "ko": "\ub124\ub35c\ub780\ub4dc",
                    "ar": "\u0647\u0648\u0644\u0646\u062f\u0627",
                    "fr": "Pays-Bas",
                    "el": "\u039f\u03bb\u03bb\u03b1\u03bd\u03b4\u03af\u03b1 (\u039a\u03ac\u03c4\u03c9 \u03a7\u03ce\u03c1\u03b5\u03c2)",
                    "tr": "Hollanda",
                    "da": "Holland",
                    "sk": "Holandsko",
                    "sr": "\u0425\u043e\u043b\u0430\u043d\u0434\u0438\u0458\u0430",
                    "zh": "\u8377\u5170",
                    "sv": "Nederl\u00e4nderna",
                    "et": "Holland",
                    "bg": "\u041d\u0438\u0434\u0435\u0440\u043b\u0430\u043d\u0434\u0438\u044f",
                    "cs": "Nizozemsko",
                    "de": "Niederlande",
                    "hr": "Nizozemska",
                    "th": "\u0e40\u0e19\u0e40\u0e18\u0e2d\u0e23\u0e4c\u0e41\u0e25\u0e19\u0e14\u0e4c",
                    "hu": "Hollandia",
                    "es": "Pa\u00edses Bajos",
                    "pl": "Holandia",
                    "fa": "\u0647\u0644\u0646\u062f",
                    "vi": "H\u00e0 Lan",
                    "ru": "\u041d\u0438\u0434\u0435\u0440\u043b\u0430\u043d\u0434\u044b",
                    "ja": "\u30aa\u30e9\u30f3\u30c0",
                    "it": "Paesi Bassi",
                    "pt": "Pa\u00edses Baixos",
                    "lt": "Nyderlandai",
                    "fi": "Alankomaat"
                },
                "h2h": "https:\/\/livescore-api.com\/api-client\/teams\/head2head.json?key=demo_key&secret=demo_secret&team1_id=1460&team2_id=1649"
            }
        ],
        "next_page": "https:\/\/livescore-api.com\/api-client\/fixtures\/matches.json?key=demo_key&secret=demo_secret&v=&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 order to get all the fixtures. In this example, we have used your api key and secret pair. If you copy the URL it will work straight away. cUrl:

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


In the examples below we show how you can get all the fixtures for today using our fixtures football API date filter. cUrl:

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


Didn't find what you need?

Do no hesitate to contact us. We will get back to you as soon as possible.