All Livescores
GET https://soccer.sportmonks.com/api/v2.0/livescores
Introduction
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.
Pagination
YES - Indicates if this endpoint contains pagination.
Nested Includes
10 - You can add a maximum of 10 levels of nested includes.
Includes Options
localTeam visitorTeam substitutions goals cards other events corners
lineup bench sidelined comments tvstations highlights round stage
referee venue odds inplayOdds flatOdds localCoach visitorCoach group
trends stats probability valuebet news
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
leagues | null | A comma separated list of leagues. Max 25 ids can be included. | |
markets | null | Filter odds based on a comma separated list of market ids. | |
bookmakers | null | Filter odds based on a comma separated list of bookmaker ids. | |
fixtures | null | Comma separated list of ids to filter on livescores. | |
includes | null | Enrich the API with more data and/or nested includes |
RESPONSES
status: OK
{"data":[],"meta":{"subscription":{"started_at":{"date":"2019-09-02 09:52:14.000000","timezone_type":3,"timezone":"UTC"},"trial_ends_at":{"date":"2019-09-16 09:52:10.000000","timezone_type":3,"timezone":"UTC"},"ends_at":null},"plan":{"name":"PostMan Plan","price":"25.00","request_limit":"2000,60"},"sports":[{"id":1,"name":"Soccer","current":true}],"pagination":{"total":0,"count":0,"per_page":100,"current_page":1,"total_pages":0,"links":{}}}}