1 of 3

Livescores

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 Statistics etc.

For many customers, Livescores is the main endpoint for their app/website. Be aware your access is limited to games of the Leagues that are 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 two 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.

In the the fixtures will be available 15 minutes before the match has started and 15 mins after it has ended.

Check this endpoint in Postman.

GET All Livescores

`GET` All Livescores

Endpoint details

Authorization

API Key

Parameters

Include options

localTeam visitorTeam substitutions goals cards other events corners lineup bench sidelined comments tvstations

Includes are the cornerstone of our API and allow you to enrich and customize your requests. This flexibility is what distinguishes us from our competitors.

You can learn more about what includes are and how they work here:

Example response

Check this endpoint in Postman.

GET All In play Livescores

`GET` All Inplay Livescores

Endpoint details

Authorization

API Key

Parameters

Include options

localTeam visitorTeam substitutions goals cards other events corners lineup bench sidelined comments tvstations

Includes are the cornerstone of our API and allow you to enrich and customize your requests. This flexibility is what distinguishes us from our competitors.

You can learn more about what includes are and how they work here:

Example response

Check this endpoint in Postman.

GET All Livescores

`GET` All Livescores

https://soccer.sportmonks.com/api/v2.0/livescores

Endpoint details

Authorization

API Key

Parameters

Include options

localTeam visitorTeam substitutions goals cards other events corners lineup bench sidelined comments tvstations

Includes are the cornerstone of our API and allow you to enrich and customize your requests. This flexibility is what distinguishes us from our competitors.

You can learn more about what includes are and how they work here:

Example response

Check this endpoint in Postman.

    "data": [
        {
            "id": 18219698,
            "league_id": 1963,
            "season_id": 18199,
            "stage_id": 77452905,
            "round_id": 252774,
            "group_id": null,
            "aggregate_id": null,
            "venue_id": 342964,
            "referee_id": null,
            "localteam_id": 250543,
            "visitorteam_id": 250542,
            "winner_team_id": 250543,
            "weather_report": {
                "code": "clouds",
                "type": "overcast clouds",
                "icon": "https://cdn.sportmonks.com/images/weather/04d.png",
                "temperature": {
                    "temp": 53.8,
                    "unit": "fahrenheit"
                },
                "temperature_celcius": {
                    "temp": 12.1,
                    "unit": "celcius"
                },
                "clouds": "90%",
                "humidity": "81%",
                "pressure": 1008,
                "wind": {
                    "speed": "10 m/s",
                    "degree": 38
                },
                "coordinates": {
                    "lat": -43.5333,
                    "lon": 172.6333
                },
                "updated_at": "2021-07-31T23:45:04.789433Z"
            },
            "commentaries": false,
            "attendance": null,
            "pitch": null,
            "details": null,
            "neutral_venue": false,
            "winning_odds_calculated": true,
            "formations": {
                "localteam_formation": null,
                "visitorteam_formation": null
            },
            "scores": {
                "localteam_score": 1,
                "visitorteam_score": 0,
                "localteam_pen_score": null,
                "visitorteam_pen_score": null,
                "ht_score": null,
                "ft_score": "1-0",
                "et_score": null,
                "ps_score": null
            },
            "time": {
                "status": "FT",
                "starting_at": {
                    "date_time": "2021-08-01 00:00:00",
                    "date": "2021-08-01",
                    "time": "00:00:00",
                    "timestamp": 1627776000,
                    "timezone": "UTC"
                },
                "minute": 90,
                "second": null,
                "added_time": null,
                "extra_minute": null,
                "injury_time": null
            },
            "coaches": {
                "localteam_coach_id": null,
                "visitorteam_coach_id": null
            },
            "standings": {
                "localteam_position": 4,
                "visitorteam_position": 6
            },
            "assistants": {
                "first_assistant_id": null,
                "second_assistant_id": null,
                "fourth_official_id": null
            },
            "leg": "1/1",
            "colors": null,
            "deleted": false,
            "is_placeholder": false
        },
        {
            "id": 18325598,
            "league_id": 1715,
            "season_id": 18765,
            "stage_id": 77454772,
            "round_id": 257110,
            "group_id": 245954,
            "aggregate_id": null,
            "venue_id": null,
            "referee_id": null,
            "localteam_id": 8283,
            "visitorteam_id": 19186,
            "winner_team_id": null,
            "weather_report": null,
            "commentaries": false,
            "attendance": null,
            "pitch": null,
            "details": null,
            "neutral_venue": false,
            "winning_odds_calculated": true,
            "formations": {

    "data": [
        {
            "id": 18219698,
            "league_id": 1963,
            "season_id": 18199,
            "stage_id": 77452905,
            "round_id": 252774,
            "group_id": null,
            "aggregate_id": null,
            "venue_id": 342964,
            "referee_id": null,
            "localteam_id": 250543,
            "visitorteam_id": 250542,
            "winner_team_id": 250543,
            "weather_report": {
                "code": "clouds",
                "type": "overcast clouds",
                "icon": "https://cdn.sportmonks.com/images/weather/04d.png",
                "temperature": {
                    "temp": 53.8,
                    "unit": "fahrenheit"
                },
                "temperature_celcius": {
                    "temp": 12.1,
                    "unit": "celcius"
                },
                "clouds": "90%",
                "humidity": "81%",
                "pressure": 1008,
                "wind": {
                    "speed": "10 m/s",
                    "degree": 38
                },
                "coordinates": {
                    "lat": -43.5333,
                    "lon": 172.6333
                },
                "updated_at": "2021-07-31T23:45:04.789433Z"
            },
            "commentaries": false,
            "attendance": null,
            "pitch": null,
            "details": null,
            "neutral_venue": false,
            "winning_odds_calculated": true,
            "formations": {
                "localteam_formation": null,
                "visitorteam_formation": null
            },
            "scores": {
                "localteam_score": 1,
                "visitorteam_score": 0,
                "localteam_pen_score": null,
                "visitorteam_pen_score": null,
                "ht_score": null,
                "ft_score": "1-0",
                "et_score": null,
                "ps_score": null
            },
            "time": {
                "status": "FT",
                "starting_at": {
                    "date_time": "2021-08-01 00:00:00",
                    "date": "2021-08-01",
                    "time": "00:00:00",
                    "timestamp": 1627776000,
                    "timezone": "UTC"
                },
                "minute": 90,
                "second": null,
                "added_time": null,
                "extra_minute": null,
                "injury_time": null
            },
            "coaches": {
                "localteam_coach_id": null,
                "visitorteam_coach_id": null
            },
            "standings": {
                "localteam_position": 4,
                "visitorteam_position": 6
            },
            "assistants": {
                "first_assistant_id": null,
                "second_assistant_id": null,
                "fourth_official_id": null
            },
            "leg": "1/1",
            "colors": null,
            "deleted": false,
            "is_placeholder": false
        },
        {
            "id": 18325598,
            "league_id": 1715,
            "season_id": 18765,
            "stage_id": 77454772,
            "round_id": 257110,
            "group_id": 245954,
            "aggregate_id": null,
            "venue_id": null,
            "referee_id": null,
            "localteam_id": 8283,
            "visitorteam_id": 19186,
            "winner_team_id": null,
            "weather_report": null,
            "commentaries": false,
            "attendance": null,
            "pitch": null,
            "details": null,
            "neutral_venue": false,
            "winning_odds_calculated": true,
            "formations": {

GET All In play Livescores

`GET` All Inplay Livescores

https://soccer.sportmonks.com/api/v2.0/livescores/now

Endpoint details

Authorization

API Key

Parameters

Include options

localTeam visitorTeam substitutions goals cards other events corners lineup bench sidelined comments tvstations

Includes are the cornerstone of our API and allow you to enrich and customize your requests. This flexibility is what distinguishes us from our competitors.

You can learn more about what includes are and how they work here:

Example response

Check this endpoint in Postman.

"data": [
     {
            "id": 18235436,
            "league_id": 1525,
            "season_id": 18607,
            "stage_id": 77454430,
            "round_id": 253354,
            "group_id": null,
            "aggregate_id": null,
            "venue_id": 8805,
            "referee_id": null,
            "localteam_id": 12894,
            "visitorteam_id": 4000,
            "winner_team_id": null,
            "weather_report": {
                "code": "clouds",
                "type": "broken clouds",
                "icon": "https://cdn.sportmonks.com/images/weather/04d.png",
                "temperature": {
                    "temp": 82.04,
                    "unit": "fahrenheit"
                },
                "temperature_celcius": {
                    "temp": 27.8,
                    "unit": "celcius"
                },
                "clouds": "66%",
                "humidity": "37%",
                "pressure": 1013,
                "wind": {
                    "speed": "5.23 m/s",
                    "degree": 1
                },
                "coordinates": {
                    "lat": 51.203,
                    "lon": 58.3266
                },
                "updated_at": "2021-08-04T15:00:15.873956Z"
            },
            "commentaries": false,
            "attendance": null,
            "pitch": null,
            "details": null,
            "neutral_venue": false,
            "winning_odds_calculated": false,
            "formations": {
                "localteam_formation": null,
                "visitorteam_formation": null
            },
            "scores": {
                "localteam_score": 0,
                "visitorteam_score": 0,
                "localteam_pen_score": null,
                "visitorteam_pen_score": null,
                "ht_score": "0-0",
                "ft_score": null,
                "et_score": null,
                "ps_score": null
            },
            "time": {
                "status": "LIVE",
                "starting_at": {
                    "date_time": "2021-08-04 13:00:00",
                    "date": "2021-08-04",
                    "time": "13:00:00",
                    "timestamp": 1628082000,
                    "timezone": "UTC"
                },
                "minute": 52,
                "second": "04",
                "added_time": null,
                "extra_minute": null,
                "injury_time": null
            },
            "coaches": {
                "localteam_coach_id": 37265768,
                "visitorteam_coach_id": 470829
            },
            "standings": {
                "localteam_position": 13,
                "visitorteam_position": 10
            },
            "assistants": {
                "first_assistant_id": null,
                "second_assistant_id": null,
                "fourth_official_id": null
            },
            "leg": "1/1",
            "colors": {
                "localteam": {
                    "color": "#C40010",
                    "kit_colors": "#C40010,#C40010,#C40010,#00C1BA,#C40010,#0046A8,#C40010"
                },
                "visitorteam": {
                    "color": "#F0F0F0",
                    "kit_colors": "#F0F0F0,#F0F0F0,#0A0A0A,#0A0A0A,#C40010,#0046A8,#022857"
                }
            },
            "deleted": false,
            "is_placeholder": false
        },

Livescores

GET All Livescores

hashtagGET All Livescores

hashtagParameters

hashtagInclude options

hashtagExample response

GET All In play Livescores

hashtagGET All Inplay Livescores

hashtagParameters

hashtagInclude options

hashtagExample response

Livescores

GET All Livescores

hashtagGET All Livescores

hashtagParameters

hashtagInclude options

hashtagExample response

GET All In play Livescores

hashtagGET All Inplay Livescores

hashtagParameters

hashtagInclude options

hashtagExample response

`GET` All Livescores

Parameters

Include options

Example response

`GET` All Inplay Livescores

Parameters

Include options

Example response

`GET` All Livescores

Parameters

Include options

Example response

`GET` All Inplay Livescores

Parameters

Include options

Example response