# API Quick Nav

## Football API Endpoints

### Core & reference data

Essential reference data used across the API.

| Endpoint                                                                   | Description                                         |
| -------------------------------------------------------------------------- | --------------------------------------------------- |
| [Cities](https://docs.sportmonks.com/v3/core-api/endpoints/cities)         | City information for venues and teams               |
| [Continents](https://docs.sportmonks.com/v3/core-api/endpoints/continents) | Continental regions                                 |
| [Countries](https://docs.sportmonks.com/v3/core-api/endpoints/countries)   | Country data for leagues and teams                  |
| [Filters](https://docs.sportmonks.com/v3/core-api/endpoints/filters)       | Available filter options for queries                |
| [Regions](https://docs.sportmonks.com/v3/core-api/endpoints/regions)       | Regional subdivisions within countries              |
| [Timezones](https://docs.sportmonks.com/v3/core-api/endpoints/timezones)   | Timezone information for fixture scheduling         |
| [Types](https://docs.sportmonks.com/v3/core-api/endpoints/types)           | Type definitions for statistics, events, and states |

### Live match data

Real-time and fixture-related data.

| Endpoint                                                                                     | Description                                      |
| -------------------------------------------------------------------------------------------- | ------------------------------------------------ |
| [Commentaries](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/commentaries) | Live match commentary and text updates           |
| [Fixtures](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/fixtures)         | Match fixtures with comprehensive data           |
| [Livescores](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/livescores)     | Real-time scores for live matches                |
| [States](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/states)             | Fixture state information (live, finished, etc.) |

### Teams & squads

Team information and squad management.

| Endpoint                                                                                             | Description                             |
| ---------------------------------------------------------------------------------------------------- | --------------------------------------- |
| [Team Squads](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/team-squads)           | Current squad rosters for teams         |
| [Teams](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/teams)                       | Team profiles and information           |
| [Transfer Rumours](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/transfer-rumours) | Player transfer speculation and rumours |
| [Transfers](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/transfers)               | Player transfer history and records     |

### Players & personnel

Individual player and staff data.

| Endpoint                                                                             | Description                            |
| ------------------------------------------------------------------------------------ | -------------------------------------- |
| [Coaches](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/coaches)   | Manager and coaching staff information |
| [Players](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/players)   | Player profiles and career data        |
| [Referees](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/referees) | Match official information             |

### Competitions & seasons

League and competition structures.

| Endpoint                                                                               | Description                                |
| -------------------------------------------------------------------------------------- | ------------------------------------------ |
| [Leagues](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/leagues)     | Competition and league information         |
| [Rounds](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/rounds)       | Matchday rounds within seasons             |
| [Schedules](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/schedules) | Season fixture schedules                   |
| [Seasons](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/seasons)     | Season data for leagues and competitions   |
| [Stages](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/stages)       | Competition stages (group, knockout, etc.) |

### Statistics & performance

Match and player statistics.

| Endpoint                                                                                                       | Description                            |
| -------------------------------------------------------------------------------------------------------------- | -------------------------------------- |
| [Aggregated Topscorers](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/aggregated-topscorers) | Combined topscorer data across seasons |
| [Standings](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/standings)                         | League tables and rankings             |
| [Statistics](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/statistics)                       | Detailed match and player statistics   |
| [Topscorers](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/topscorers)                       | Leading scorers by competition         |

### Predictions & analysis

Advanced analytics and predictions.

| Endpoint                                                                                                             | Description                                 |
| -------------------------------------------------------------------------------------------------------------------- | ------------------------------------------- |
| [Expected (xG)](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/expected-xg)                         | Expected goals and shot quality metrics     |
| [Predictions](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/predictions)                           | Match outcome predictions and probabilities |
| [Premium Expected Lineups](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/premium-expected-lineups) | AI-predicted starting lineups               |
| [Rivals](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/rivals)                                     | Historical rivalry data between teams       |

### Beta features

New features currently in beta testing.

| Endpoint                                                                                                              | Description                              |
| --------------------------------------------------------------------------------------------------------------------- | ---------------------------------------- |
| [Match Facts](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/match-facts-beta)                       | Pre and post-match analysis and insights |
| [Team of the Week (TOTW)](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/team-of-the-week-totw-beta) | Best-performing players each round       |
| [Team Rankings](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/team-rankings-beta)                   | Historical team ranking data             |

### Odds & betting

Betting markets and odds data.

| Endpoint                                                                                                 | Description                          |
| -------------------------------------------------------------------------------------------------------- | ------------------------------------ |
| [Bookmakers](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/bookmakers)                 | Betting bookmaker information        |
| [Markets](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/markets)                       | Betting market types and definitions |
| [Premium Odds Feed](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/premium-odds-feed)   | High-frequency premium odds data     |
| [Standard Odds Feed](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/standard-odds-feed) | Pre-match and in-play odds           |

### Additional data

Supplementary information and content.

| Endpoint                                                                                   | Description                       |
| ------------------------------------------------------------------------------------------ | --------------------------------- |
| [News](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/news)               | Pre and post-match news articles  |
| [TV Stations](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/tv-stations) | Broadcast information for matches |
| [Venues](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/venues)           | Stadium and venue details         |

### Quick reference

#### By use case

**Building a livescore app?**\
Start with: [Livescores](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/livescores), [Fixtures](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/fixtures), [Events](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/events)

**Building a statistics dashboard?**\
Start with: [Statistics](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/statistics), [Standings](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/standings), [Types](https://docs.sportmonks.com/v3/core-api/types)

**Building a team profile page?**\
Start with: [Teams](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/teams), [Team Squads](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/team-squads), [Fixtures](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/fixtures)

**Building a predictions platform?**\
Start with: [Predictions](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/predictions), [Expected (xG)](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/expected), [Trends](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/trends)

**Building a fantasy football app?**\
Start with: [Players](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/players), [Statistics](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/statistics), [Fixtures](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/fixtures)

### All Endpoints (Alphabetical)

**A**

* [Aggregated Topscorers](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/aggregated-topscorers)

**B**

* [Bookmakers](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/bookmakers)

**C**

* [Cities](https://docs.sportmonks.com/v3/core-api/endpoints/cities)
* [Coaches](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/coaches)
* [Commentaries](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/commentaries)
* [Continents](https://docs.sportmonks.com/v3/core-api/endpoints/continents)
* [Countries](https://docs.sportmonks.com/v3/core-api/endpoints/countries)

**E**

* [Expected (xG)](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/expected-xg)

**F**

* [Filters](https://docs.sportmonks.com/v3/core-api/endpoints/filters)
* [Fixtures](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/fixtures)

**L**

* [Leagues](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/leagues)
* [Livescores](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/livescores)

**M**

* [Markets](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/markets)
* [Match Facts (beta)](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/match-facts-beta)

**N**

* [News](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/news)

**P**

* [Players](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/players)
* [Predictions](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/predictions)
* [Premium Expected Lineups](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/premium-expected-lineups)
* [Premium Odds Feed](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/premium-odds-feed)

**R**

* [Referees](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/referees)
* [Regions](https://docs.sportmonks.com/v3/core-api/endpoints/regions)
* [Rivals](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/rivals)
* [Rounds](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/rounds)

**S**

* [Schedules](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/schedules)
* [Seasons](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/seasons)
* [Stages](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/stages)
* [Standard Odds Feed](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/standard-odds-feed)
* [Standings](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/standings)
* [States](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/states)
* [Statistics](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/statistics)

**T**

* [Team of the Week (TOTW) (beta)](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/team-of-the-week-totw-beta)
* [Team Rankings (beta)](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/team-rankings-beta)
* [Team Squads](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/team-squads)
* [Teams](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/teams)
* [Timezones](https://docs.sportmonks.com/v3/core-api/endpoints/timezones)
* [Topscorers](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/topscorers)
* [Transfer Rumours](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/transfer-rumours)
* [Transfers](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/transfers)
* [TV Stations](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/tv-stations)
* [Types](https://docs.sportmonks.com/v3/core-api/endpoints/types)

**V**

* [Venues](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/venues)

### Need Help?

* 📚 [Getting Started Guide](https://docs.sportmonks.com/v3/welcome/getting-started)
* 🎓 [Tutorials](https://docs.sportmonks.com/v3/football/tutorials)
* ❓ [FAQ](https://docs.sportmonks.com/v3/faq)
* 📧 Support: <support@sportmonks.com>


---

# 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/v3/api-quick-nav.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.