GET All Livescores

This endpoint returns all the live fixtures available in our Motorsport API.

To retrieve results for a fixture, you can use the results include. Alternatively, you can use the lineups.details nested include to retrieve additional lineup information and more result types. The types for these results are described in Results & Live Data Type Reference.

You can also use the metadata include to enrich the response with detailed information about the fixture, like the current and total lap count, race distance and fastest lap. The type reference for these details are described in Metadata & Per-Season Data Type Reference.

https://api.sportmonks.com/v3/motorsport/livescores

{
    "data": [
        {
            "id": 19398653,
            "sport_id": 2,
            "league_id": 3468,
            "season_id": 25273,
            "stage_id": 77475992,
            "group_id": null,
            "aggregate_id": null,
            "round_id": null,
            "state_id": 5,
            "venue_id": 343575,
            "name": "Practice 1",
            "starting_at": "2025-03-14 01:30:00",
            "result_info": null,
            "leg": "1/1",
            "details": null,
            "length": null,
            "placeholder": false,
            "has_odds": false,
            "has_premium_odds": false,
            "starting_at_timestamp": 1741915800
        },

Field

Description

Type

id

Refers the unique id of the fixture

integer

sport_id

Refers to the sport of the fixture

integer

league_id

Refers to the league the fixture is held in

integer

season_id

Refers to the seasons the fixture is held in

integer

stage_id

Refers to the stage (e.g. race weekend) the fixture is held in

integer

group_id

Not used in the Motorsport API

null

aggregate_id

Not used in the Motorsport API

null

round_id

Not used in the Motorsport API

null

state_id

Refers to the state the fixture is currently in

integer

venue_id

Refers to the venue (track) the fixture is held at

integer

name

Represents the name of the fixture

string

starting_at

String representing the start date and time

date

result_info

Represents the final result info

string

leg

Represents the stage of the fixture, e.g. 2/3 for Practice 2 (of 3) or 3/3 for Qualification 3. Note: Returns 1/1 for Practice 1 if the other practice sessions are replaced by the sprint sessions.

string

details

Represents details about the fixture

string

length

Planned length of the session in minutes (practice and qualification sessions); Total amount of laps (race sessions)

integer

placeholder

Represents if the fixture is a placeholder

boolean

has_odds

Not used in the Motorsport API

boolean

has_premium_odds

Not used in the Motorsport API

boolean

starting_at_timestamp

Integer representing the starting Unix timestamp (in seconds since Unix Epoch)

integer

Query Parameters

Required?

Description

api_token

YES

Your unique API token

include

Enrich the API with more data by using includes

select

Select specific fields on the base entity

filters

Filter the API response on multiple related entities. There are static filters and dynamic filters.

Please find the possibilities in the Static and Dynamic Filter tab.

Static filters are always the same and filter in one specific way without any custom options. Each static filter is listed below and has a description of how it filters. For more information, please look at our Filters page.

Not applicable for this endpoint.

Pagination

YES

Include depth

You can use a total of 3 nested includes on this endpoint

Include options

sport stage league season venue state lineups participants metadata results latestLaps pitstops latestPitstops stints latestStints

Related Entities:

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

Live

Code Example

require "uri"
require "net/http"

url = URI("https://api.sportmonks.com/v3/motorsport/livescores?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/motorsport/livescores?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/motorsport/livescores?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/motorsport/livescores?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/motorsport/livescores?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/motorsport/livescores?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))
}

PreviousLive

NextFixtures

Last updated 6 months ago

Was this helpful?