Get All Inplay Fixtures

  • Basic
  • Standard
  • Advanced
  • Custom


Via the Livescore endpoint, you can obtain live data of Games of the current day and live data for In Play Games. The Livescore endpoint provides real-time data about Game information and Events like Goals, Cards, Substitutions, Line-ups, In Play Stats etc.

For many customers, Livescores is the main endpoint for their app/website. Be aware your access is limited to Livescore Games of Leagues, available in the Plan you are subscribed to.

Responses of the Livescore endpoint are highly customizable, because there are many Includes available to extend the response. There are always 2 teams involved in a Livescore Game. Requests often start with the Includes localTeam and visitorTeam. Events, Stats, Lineups, Comments, Trends etc. are often added to extend the response.

Endpoint Details

Below you can find the details for this endpoint.

Key Value
Pagination: No

Nested Includes: 10 - You can add a max of 10 levels of nested includes.
  • leagues - A comma separated list of leagues. Max 25 ids can be included.
  • api_token - Your token that privdes access to the API.
  • bookmakers - Filter odds based on a comma separated list of bookmaker ids.
  • markets - Filter odds based on a comma separated list of market ids.
  • fixtures - Comma separated list of ids to filter on livescores.

Example Request

The following code snippets demonstrate how to get all livescores available in this endpoint.

// Get your API tokens here:
curl ""
-H "Accept: application/json"
// Get your API tokens here:
$client = new GuzzleHttp\Client();
$res = $client->request('GET', '', [
    'headers' => ['Accept' => 'application/json']
// Get your API tokens here:
response = requests.get("")

# Print the status code of the response.
// Get your API tokens here:
require 'faraday_middleware''', headers: {'Accept' => 'application/json', 'Accept-Encoding' => 'gzip'}).get
// Get your API tokens here:
URL url = new URL("");
HttpURLConnection con = (HttpURLConnection) url.openConnection();
// Get your API tokens here:
import { SportmonksApi } from 'sportmonks';
const sportmonks = new SportmonksApi(__YOUR_API_TOKEN__);
sportmonks.get("",params).then( function(resp){
  // will contain your data
  //resp.meta will contain the meta informations
// Get your API tokens here:
package main

import (

    sm ""

func main() {
    g, err := sm.Get("", "", 0, false)
    if err != nil {
// Get your API tokens here:
var client = new HttpClient();
var response = await client.GetAsync("");
string json = await response.Content.ReadAsStringAsync();

Example Response

In the API Reference Guide the example responses of the livescores endpoint are shown.

Test this Endpoint

With our In-Page API Tester you can directly test this Endpoint by clicking the blue button on the right ‘Open Test API’. By adding Includes, Parameters and Variables and clicking the blue button on the right below ‘Send API Request’, you can directly view the API Response. Your Requests and Responses are even stored in your personal API Tester Folder (only when you are logged-in). If you are not logged in the API Tester will use the Free Plan Leagues for your requests.


We're always happy to help with code or other questions you might have! Search our documentation, contact support, or get in touch with our sales team.

This article was last updated on 2018-12-14 15:49:48
{{ api_response }}
# Variable Value Description
{{ variable.variable }} {{ variable.description }}
# Relationship Description Value
{{ parameter.parameter }} {{ parameter.description }}
# Relationship Description Extra
{{ relation.include }} {{ relation.description }}

{{ loginForm.errors.get('email') }}

{{ loginForm.errors.get('password') }}

Remember me?