A
A
API 3.0 (BETA)
Football API 3.0 (BETA)
Search…
⌃K

GET Latest Updated Fixtures

Returns you all the games that have received updates within 5 minutes.
Base URL
Example Response
Field Description
https://api.sportmonks.com/v3/football/fixtures/latest
"data": [
{
"id": 18448123,
"inplay": 0,
"sport_id": 1,
"league_id": 2437,
"season_id": 19126,
"stage_id": 77456032,
"group_id": null,
"aggregate_id": null,
"round_id": 264620,
"state_id": 1,
"venue_id": null,
"name": "Partizan U19 vs IMT Novi Beograd U19",
"home_score": 0,
"away_score": 0,
"starting_at": "2022-05-04 08:00:00",
"result_info": null,
"ended_at": null,
"leg": "1/1",
"details": null,
"length": 90,
"placeholder": false,
"is_final_result": true
},
{
"id": 18448125,
"inplay": 0,
"sport_id": 1,
"league_id": 2437,
"season_id": 19126,
"stage_id": 77456032,
"group_id": null,
"aggregate_id": null,
"round_id": 264620,
"state_id": 1,
"venue_id": null,
"name": "Brodarac U19 vs Rad U19",
"home_score": 0,
"away_score": 0,
"starting_at": "2022-05-04 08:00:00",
"result_info": null,
"ended_at": null,
"leg": "1/1",
"details": null,
"length": 90,
"placeholder": false,
"is_final_result": true
},
{
"id": 18522388,
"inplay": 0,
"sport_id": 1,
"league_id": 1342,
"season_id": 19429,
"stage_id": 77456816,
"group_id": null,
"aggregate_id": null,
"round_id": null,
"state_id": 1,
"venue_id": 25312,
"name": "Nadi vs Lautoka",
"home_score": null,
"away_score": null,
"starting_at": "2022-05-04 07:30:00",
"result_info": null,
"ended_at": null,
"leg": "1/1",
"details": null,
"length": 90,
"placeholder": false,
"is_final_result": true
},
{
"id": 18474693,
"inplay": 0,
"sport_id": 1,
"league_id": 1025,
"season_id": 19314,
"stage_id": 77456444,
"group_id": null,
"aggregate_id": null,
"round_id": 267634,
"state_id": 5,
"venue_id": null,
"name": "Matsumoto Yamaga vs Giravanz Kitakyushu",
"home_score": 0,
"away_score": 0,
"starting_at": "2022-05-04 06:00:00",
"result_info": "Game ended in draw.",
"ended_at": "2022-05-04 07:54:50",
"leg": "1/1",
"details": null,
"length": 90,
"placeholder": false,
"is_final_result": false
}
Field
Description
Type
id
Refers the unique id of the fixture
integer
sport_id
Refers to the sport the fixture is played at
integer
league_id
Refers to the league the fixture is played in
integer
season_id
Refers to the seasons the fixture is played in
integer
stage_id
Refers to the stage the fixture is played in
integer
group_id
Refers to the group the fixture is played in
integer / null
aggregate_id
Refers to the aggregate the fixture is played at
integer / null
state_id
Refers to the state the fixture is played at
integer
round_id
Refers to the round the fixture is played at
integer / null
state_id
Refers to the state the fixture is played at
integer
venue_id
Refers to the venue the fixture is played at
integer / null
name
Represents the name of the participants
string / null
home_score
Score for the home participant
integer / null
away_score
Score for the visiting participant
integer / null
starting_at
Datetime object representing the start time
date / null
result_info
Represents the final result info
string / null
leg
Represents the leg of the fixture
string
details
Represents details about the fixture
string / null
length
Length of the fixture (minutes)
integer / null

Parameters

Query Parameters
Required?
Description
api_token
YES
Your unique API token
include
NO
Enrich the API with more data by using includes
select
NO
Select specific fields on the base entity
leagues
NO
Filter the livescores on a selection of leagues separated by a comma. (e.g: 2,8,12)
markets
NO
Filter the odds on a selection of markets separated by a comma. (e.g: 12,24)
bookmakers
NO
Filter the odds on a selection of bookmakers separated by a comma. (e.g: 12,24)

Pagination

NO

Include options

Get an overview and explanation of all the fields returned in the API response. The related entities for the fixtures endpoints are:

Code Example

Ruby
Python
PHP
Java
Node.js
Go
require "uri"
require "net/http"
url = URI("https://api.sportmonks.com/v3/football/fixtures/updates?api_token={your_token}")
https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true
request = Net::HTTP::Get.new(url)
response = https.request(request)
puts response.read_body
import http.client
conn = http.client.HTTPSConnection("api.sportmonks.com")
payload = ''
headers = {}
conn.request("GET", "/v3/football/fixtures/updates?api_token={your_token}", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://api.sportmonks.com/v3/football/fixtures/updates?api_token={your_token}',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'GET',
));
$response = curl_exec($curl);
curl_close($curl);
echo $respons
OkHttpClient client = new OkHttpClient().newBuilder()
.build();
Request request = new Request.Builder()
.url("https://api.sportmonks.com/v3/football/fixtures/updates?api_token={your_token}")
.method("GET", null)
.build();
Response response = client.newCall(request).execute();
var unirest = require('unirest');
var req = unirest('GET', 'https://api.sportmonks.com/v3/football/fixtures/updates?api_token={your_token}')
.end(function (res) {
if (res.error) throw new Error(res.error);
console.log(res.raw_body);
});
package main
import (
"fmt"
"net/http"
"io/ioutil"
)
func main() {
url := "https://api.sportmonks.com/v3/football/fixtures/updates?api_token={your_token}"
method := "GET"
client := &http.Client {
}
req, err := http.NewRequest(method, url, nil)
if err != nil {
fmt.Println(err)
return
}
res, err := client.Do(req)
if err != nil {
fmt.Println(err)
return
}
defer res.Body.Close()
body, err := ioutil.ReadAll(res.Body)
if err != nil {
fmt.Println(err)
return
}
fmt.Println(string(body))
}