Calendar fixtures
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.
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.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. A fixture is a match scheduled in the future.
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.
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.
| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| competition_id | number | 16 | the id of the competition in which the match will take place | |
| date | date/string | 2018-05-15/today | Results in showing only fixtures on that date. If you provide today as a value, our football API will return only the fixtures for today. | |
| group_id | number | 1456 | The ID of the competition group, if we want only the fixtures for this group | |
| lang | string | fa | 2 letter ISO 639-1 language code | |
| page | number | 2 | Results in sowing only fixtures on that page with results | |
| round | number/string | 19/R16 | Filters 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 | |
| team | number | 19 | Filters the fixtures by the a specific team |
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.
| Name | Type | Example | Description |
|---|---|---|---|
| away | object | {} | An object holding the information about the away team in the fixture. It has the structure of our standard team object. |
| competition | object | {} | An object holding the information about the competition in which the fixture is scheduled. It has the structure of our standard competition object. |
| country | object | null | {} | An object holding the information about the country in which the fixtures is scheduled. It has the structure of our standard country object. If the match is part of an international competition like the UEFA Champions League, the value of the country will be null. |
| date | date | 2018-05-15 | the data when the football match is going to be played. |
| federation | object | null | {} | An object holding the information about the federation in which the fixture is scheduled. It has the structure of our standard federation object. If the match is part of an national competition like the English Premier League the value of the federation will be null. |
| group_id | number | 1714 | the 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 |
| home | object | {} | An object holding the information about the home team in the fixture. It has the structure of our standard team object. |
| id | number | 1578384 | The 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 |
| location | string | Torino | the place or stadium where the match is going to be played or empty if we do not have enough data. |
| odds | object | {} | An object that holds information about the pre match and live match betting odds. It has the structure of a standard odds object |
| round | integer/string | 25/QF | the 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. |
| time | time | 12:00 | the 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": [
{
"round": "21",
"date": "2025-02-03",
"away": {
"logo": "https:\/\/cdn.live-score-api.com\/teams\/ca66ecc4490c94784840aa2283ecaf04.png",
"id": 1157,
"name": "Lamia",
"country_id": 78,
"stadium": "Dimotiko Athlitiko Kentro Lamias"
},
"location": "Stadio Theodoros Kolokotronis",
"odds": {
"pre": {
"1": 1.62,
"2": 5.5,
"X": 3.6
},
"live": {
"1": null,
"2": null,
"X": null
}
},
"federation": null,
"group_id": 0,
"home": {
"logo": "https:\/\/cdn.live-score-api.com\/teams\/4576e2281e8841681768790c151d139a.png",
"id": 864,
"name": "Asteras Tripolis",
"country_id": 78,
"stadium": "Stadio Theodoros Kolokotronis"
},
"time": "16:00:00",
"country": {
"is_real": true,
"name": "Greece",
"id": 78,
"uefa_code": "GRE",
"fifa_code": "GRE",
"flag": "GRE.png"
},
"competition": {
"id": 9,
"active": true,
"has_groups": true,
"is_cup": false,
"tier": 1,
"name": "Super League",
"is_league": true,
"national_teams_only": false
},
"id": 1712210
},
{
"round": "7",
"date": "2025-02-03",
"away": {
"logo": "https:\/\/cdn.live-score-api.com\/teams\/c4c685494ae902d08825992d56117e27.png",
"id": 5366,
"name": "Al Shorta",
"country_id": 147,
"stadium": "Al-Gadarf Stadium"
},
"location": "Azadi Stadium",
"odds": {
"pre": {
"1": null,
"2": null,
"X": null
},
"live": {
"1": null,
"2": null,
"X": null
}
},
"federation": {
"id": 4,
"name": "AFC"
},
"group_id": 0,
"home": {
"logo": "https:\/\/cdn.live-score-api.com\/teams\/e998e75c7f7c5c4902b51520f411200b.png",
"id": 996,
"name": "Esteghlal",
"country_id": 18,
"stadium": "Azadi Stadium"
},
"time": "16:00:00",
"country": null,
"competition": {
"id": 243,
"active": true,
"has_groups": true,
"is_cup": true,
"tier": 1,
"name": "AFC Champions League",
"is_league": false,
"national_teams_only": false
},
"id": 1737309
}
],
"next_page": "https:\/\/livescore-api.com\/api-client\/fixtures\/matches.json?key=&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 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/list.json?key=demo_key\\&secret=demo_secretfile_get_contents('https://livescore-api.com/api-client/fixtures/list.json?key=demo_key\&secret=demo_secret');import urllib2
req = urllib2.Request('https://livescore-api.com/api-client/fixtures/list.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/list.json?date=today&key=demo_key\\&secret=demo_secretfile_get_contents('https://livescore-api.com/api-client/fixtures/list.json?date=today&key=demo_key\&secret=demo_secret');import urllib2
req = urllib2.Request('https://livescore-api.com/api-client/fixtures/list.json?date=today&key=demo_key\&secret=demo_secret')
response = urllib2.urlopen(req)
print response.read()