# 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.

{% hint style="info" %}
In the [**livescores endpoint,**](https://football-postman.sportmonks.com/#fb0b146e-2ab6-4c36-9abc-cc50c84d0bc5) the fixtures will be available 15 minutes before the match has started and 15 mins after it has ended.
{% endhint %}

{% content-ref url="/pages/-MXqYf10xD0d4dOnIx3e" %}
[GET All Livescores](/v2/endpoint-overview/livescores/get-all-livescores.md)
{% endcontent-ref %}

{% content-ref url="/pages/-MXqYeycE0WDwoZm60zu" %}
[GET All In play Livescores](/v2/endpoint-overview/livescores/get-all-in-play-livescores.md)
{% endcontent-ref %}

{% hint style="info" %}
Check this endpoint in Postman.\
&#x20;                                                             [![Run in Postman](https://run.pstmn.io/button.svg)](https://football-postman.sportmonks.com/#b850a1c2-9775-4828-8cce-3799532e06aa)
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sportmonks.com/v2/endpoint-overview/livescores.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
