Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Welcome to the documentation page about Sportmonks’ documentation! Now that you have completed our get started guide, you can freely choose what you want to go through next! Our extensive API documentation consists of the following sections:
So, yes. This is indeed a documentation page about our documentation! Our documentation sections are classified based on our users' capabilities.
The tutorial section, for instance, is mostly aimed at users without a technical/programming background. There, we show you basic requests and explain how you can use the many features of our API. The how-to guide section is aimed at more advanced users. Ideally, you'd have read through the tutorial section first before attempting to work yourself through the how-to guides. The how-to guides will show you how to send the right requests to get the API data you need for your own livescore page, match page with odds or fantasy game.
Finally, the API References, are the most common resources used by developers already familiar with APIs. We also provide our API references in Postman.
This way, you'll know where and how to navigate through our massive documentation. Good luck!
Want to know more about who we are?
We constantly seek to improve and expand our documentation. If you think something is missing, or you have an idea for a great tutorial or how-to guide, don't hesitate and contact us! We value your input. Contact us at sales@sportmonks.com.
The Continents endpoint helps you assign Countries and Leagues to the part of the world (Continent) they belong to. Available Continents are Europe, Asia, Africa, Oceania, North America and South America. Especially if you want to show many Leagues on your website/app, this might be a useful endpoint for you.
Endpoint details |
Pagination | YES |
Allowed nested includes | 3 |
Authorization | API Key |
Available parameters |
page | The number of the page you want to browse. Can be used by adding &page=2 etc to your request url. |
include | Enrich the API with more data and/or nested includes. Can be used by adding |
The Countries endpoint provides you Country information like its Flag, IsoCode, Continent and other related Country information.
The Countries endpoint also helps you with assigning Leagues to the Country they belong to. If for example, you want to show the Leagues per Country on your website/app, this might be a useful endpoint for you by using the Leagues
Include.
Check this endpoint in Postman.
With immediately effect it's not possible anymore to change the pagination default on the following endpoints:
fixtures/between{date1}/{date2}
fixtures//between/{startDate}/{endDate}/{teamId}
Added new weather types. You can check an overview of all possible outcomes on our page.
Added the opportunity to retrieve all bookmakers by Fixture ID.
Added 'is_friendly' property on league related responses or includes. This indicates if the league is friendly.
Added a new filter on the Head2Head endpoint. You can now filter between dates: &between=
This gives you the opportunity to retrieve all past (or future) matches between two teams.
Added the Rivals endpoint and include. You can now include rivals
on the teams endpoint to retrieve all the rivals of one team.
Added the opportunity to retrieve all fixtures by Market ID. This allows you to gather all fixtures that have a specific odd market available.
Added the News API (BETA) for the English Premier League and European Championship.
Added the official match numbers of the European Championship fixtures in the details
field.
Added a property on both fixture and team responses called is_placeholder
. This property indicates if the resource is used to display dummy data. The false of this property will always be a boolean
value. An example where this becomes useful: Imagine you want to load the complete schedule of the European Championship and display this in a nice visual. You would need the complete schedule including knockout games which haven't yet been determined when the season starts. This property tells you that there the data is not final or is used for placeholder purposes. The id of a fixture will remain the same when real data is merged to it.
Added a property called is_value
on the valuebet responses. This property indicates if a value still provides value. When this is set to false
you should remove the value bet from your system.
Welcome to the get started page of our Football API 2.0. You’re only a few steps away from requesting and receiving API responses for your football application.
What is Football API 2.0?
Authentication
Your first request
Get your football data
What can you do with the data?
Different plans and data features
Build creative football-related apps with our . Football API 2.0 is a that can be used to request football data from our expansive database and has the following characteristics:
Highly customizable requests
Incredibly fast livescores
Reliable and accurate data
We recommend you submit your requests with Postman since we have already prepared the request for you there! Hit the button below to import our Football API collection.
Example API token: [HdoiD312ND….]
The API token is only meant for your eyes and, as such, should be stored away safely.
Our tokens have no expiration date and will remain valid until you manually delete it yourself.
Football API 2.0 utilizes response codes to indicate successful and failed API requests. With our brand-new token, we can make our first request! But before we start let us explain which possible responses can be returned. When making a request, a code response will always be returned. See below for a shortlist of possible code responses:
Now that all prerequisites have been fulfilled, we’re ready to send our first request to the API!
The request consists of the following components:
The base URL
A path parameter, in this example, we use [leagues]
A query string parameter, this is optional, so we are leaving this out for now
And finally, your API token
An example of a correctly authenticated request would be:
The data our API provides will enable you to create excellent and specialized applications. Down below you will find two examples of Sportmonks’ partners who have made brilliant applications. Throughout our documentation pages you will find more examples, ranging from betting and odds websites to fantasy games and live score tracking websites.
There are various options as to how you’d like to send the request. Our API is compatible with an incredible number of developer languages
Phyton Wrappers:
Java Wrappers:
Ruby Wrappers:
Added 20 new leagues, including the UEFA Conference League (ID: 2286). You can check all leagues on our .
To make our first request, we’ll need a way to get authenticated first. utilizes API tokens for the authentication of requests. You can obtain your free API token and manage your API tokens For the sake of simplicity, we’ll be working with an API token within the ‘free plan’. The free plan includes the Danish Superliga (league id: 271) and the Scottish Premiership (league id: 501).
This request will return all of the leagues eligible for our , which are the Danish Superliga (league id: 271) and the Scottish Premiership (league id: 501). You can view them by clicking on the second tab.
The example above was the most basic request you can create, while our highly can handle way more advanced requests.
Node JS Wrapper:
PHP Wrapper:
Laravel PHP Wrapper:
Composer PHP Wrapper:
GO Wrapper:
Elixir Wrapper:
R Wrapper:
Golang:
Sportmonks has various different and data features for you. You can learn all about it in the matrix below. In you can choose your ideal plan and data features.
Code number | Description |
| Successful request and data was returned |
| Part of the request is malformed; the exact reason can be found in the response |
| Request is not authenticated |
| Unauthorized request to access data from an ineligible plan |
| You have reached the response rate limit of your plan |
| Internal error with our servers |
Field | Description |
| Opens an array of data you've requested |
| A unique league id |
| Indicates if the league is active or not. Possible values are 'true' or 'false' |
|
| This was for our API version 1.0. It's only of use for old users of our API |
| The unique country id the league is played in |
| The logo URL path of the league |
| The name of the league |
| Indicates if the league is a cup or not. Possible values are 'true' or 'false' |
| The unique id of the current season |
| The unique id of the current round |
| The unique id of the current stage |
| Indicates if the league covers live standings |
| Opens an array of partial coverage for the league |
| Indicates if the league covers predictions |
| Indicates if the league covers goal topscorers |
| Indicates if the league covers assists topscorers |
| Indicates if the league covers cards topscorers |
GET
All Countriesleagues
continent
covid
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:
GET
All Leaguescountry
season
seasons
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:
GET
League by IDcountry
season
seasons
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:
GET
Country by IDleagues
continent
covid
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:
For most customers, the Leagues endpoint is the starting point. A request on this endpoint returns a response with all Leagues you have access to, based on the plan you are subscribed to.
The Leagues endpoint provides you League information like its ID, Name, Country, Coverage etc.
The endpoint is often used in combination with the Season
or Seasons
Includes. Where the Season
include returns information about the active Season only, the Seasons
Include returns information about all seasons available for the specific Leagues.
Check this endpoint in Postman.
GET
League by Country IDcountry
season
seasons
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:
Check this endpoint in Postman.
Responses of the Seasons endpoint are limited to Seasons of the Leagues available in the Plan you are subscribed to. Responses provide you details like the Season ID, Name, League ID, Year and if the Season is Active Yes or No.
One of the main features of the Seasons endpoint is the ability to retrieve full Season Games, (history) Fixtures, Results or Upcoming Fixtures. This can be achieved by using the proper Includes, which are listed in the section Endpoint Details.
Check this endpoint in Postman.
Here you will find everything you need to know about Sportmonks’ Football API 2.0 (Deprecated).
This version of the API is deprecated. Please visit the of our brand new API 3.0
Welcome to the documentation overview of . We'll briefly inform you about the features of our API and then you can explore our documentation for yourself.
Sportmonks offers standard REST APIs. Requests are sent with URLs and responses will be returned in JSON format. Every authentication is spearheaded by an API token. We have assembled a library of all of our endpoints including example requests in Postman.
This endpoint returns an array of Leagues that meet your search criteria. Note that it will not return Leagues that are not covered by your subscription plan. The Leagues endpoint provides League information like its ID, Name, Country, Coverage etc.
country
season
seasons
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:
GET
All Seasonsleague
stages
rounds
upcoming
results
groups
goalscorers
cardscorers
assistscorers
aggregatedGoalscorers
aggregatedCardscorers
aggregatedAssistscorers
fixtures
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:
GET
Fixture by IDlocalTeam
visitorTeam
substitutions
goals
cards
other
events
corners
lineup
bench
sidelined
comments
tvstations
highlights
round
stage
referee
venue
odds
inplayOdds
flatOdds
localCoach
visitorCoach
group
trends
firstAssistant
secondAssistant
fourthOfficial
stats
shootout
league
stats
probability
valuebet
news
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:
The Fixture endpoint provides information about Games in particular Leagues. There are always two teams involved in a Fixture. For many customers, Fixtures is the main endpoint for their app/website. Be aware your access is limited to Fixtures of Leagues, available in the Plan you are subscribed to.
Responses of the Fixture endpoint are highly customizable because there are many Includes available to extend the response. Requests often start with the Includes localTeam
and VisitorTeam
. Events
, Stats
, Lineups
, Comments
, Trends
etc. are often added as well.
Check this endpoint in Postman.
GET
Season by IDleague
stages
rounds
upcoming
results
groups
goalscorers
cardscorers
assistscorers
aggregatedGoalscorers
aggregatedCardscorers
aggregatedAssistscorers
fixtures
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:
Check this endpoint in Postman.
Indicates what kind of league this is. Possible values: 'domestic', 'cup', 'international'. More values can be found
Check this endpoint in Postman.
We recommend you submit your requests with Postman since we have already prepared the request for you there! Hit the button below to import our Football API collection.
If you want to get started right away, great! Head over to our , where you'll create your own API token and create your first request.
Else, you can refer to our , to see what's relevant for you.
Are you here for our ? No problem here's a link and enjoy! For any technical questions, you can email our support team.
Check this endpoint in Postman.
Check this endpoint in Postman.
Check this endpoint in Postman.
Field
Description
data
Opens an array of data you've requested
id
A unique league id
active
Indicates if the league is active or not. Possible values are 'true' or 'false'
type
Indicates what kind of league this is. Possible values: 'domestic', 'cup', 'international'. More values can be found here
legacy_id
This was for our API version 1.0. It's only of use for old users of our API
country_id
The unique country id the league is played in
logo_path
The logo URL path of the league
name
The name of the league
is_cup
Indicates if the league is a cup or not. Possible values are 'true' or 'false'
current_season_id
The unique id of the current season
current_round_id
The unique id of the current round
current_stage_id
The unique id of the current stage
live_standings
Indicates if the league covers live standings
coverage
Opens an array of partial coverage for the league
predictions
Indicates if the league covers predictions
topscorers_goals
Indicates if the league covers goal topscorers
topscorers_assists
Indicates if the league covers assists topscorers
topscorers_cards
Indicates if the league covers cards topscorers
Field
Description
data
Opens an array of data you've requested
id
A unique league id
active
Indicates if the league is active or not. Possible values are 'true' or 'false'
type
Indicates what kind of league this is. Possible values: 'domestic', 'cup', 'international'. More values can be found here
legacy_id
This was for our API version 1.0. It's only of use for old users of our API
country_id
The unique country id the league is played in
logo_path
The logo URL path of the league
name
The name of the league
is_cup
Indicates if the league is a cup or not. Possible values are 'true' or 'false'
current_season_id
The unique id of the current season
current_round_id
The unique id of the current round
current_stage_id
The unique id of the current stage
live_standings
Indicates if the league covers live standings
coverage
Opens an array of partial coverage for the league
predictions
Indicates if the league covers predictions
topscorers_goals
Indicates if the league covers goal topscorers
topscorers_assists
Indicates if the league covers assists topscorers
topscorers_cards
Indicates if the league covers cards topscorers
Endpoint details
Authorization
API Key
Pagination
YES
Allowed nested includes
2
Available parameters
page
The number of the page you want to browse. Can be used by adding &page=
etc to your request url.
include
Enrich the API with more data and/or nested includes. Can be used by adding &include=
etc. to your request url.
Endpoint details
Authorization
API Key
Pagination
YES
Allowed nested includes
2
Available parameters
page
The number of the page you want to browse. Can be used by adding &page=
etc to your request url.
include
Enrich the API with more data and/or nested includes. Can be used by adding &include
= etc. to your request url.
cupslast
When provided via the request url the cups will be put on the end of the response.
Endpoint details
Pagination
YES
Allowed nested includes
2
Authorization
API Key
Available parameters
page
The number of the page you want to browse. Can be used by adding &page=2 etc to your request url.
include
Enrich the API with more data and/or nested includes. Can be used by adding &include=
etc. to your request url.
Field | Description |
| Opens an array of data you've requested |
| The unique season id |
| The name of the season |
| The unique league id the season belongs to |
| Indicates if the season is the current one. Possible values are "true" or "false" |
| The unique id of the current round |
| The unique id of the current stage |
Endpoint details
Authorization
API Key
Pagination
NO
Allowed nested includes
2
Available parameters
include
Enrich the API with more data and/or nested includes. Can be used by adding &include=
etc. to your request url.
Endpoint details |
Authorization | API Key |
Pagination | YES |
Allowed nested includes | 3 |
Available parameters |
page | The number of the page you want to browse. Can be used by adding |
include | Enrich the API with more data and/or nested includes. Can be used by adding |
Endpoint details |
Authorization | API Key |
Pagination | NO |
Allowed nested includes | 2 |
Available parameters |
include | Enrich the API with more data and/or nested includes. Can be used by adding |
Endpoint details |
Authorization | API Key |
Pagination | YES |
Allowed nested includes | 4 |
Available parameters |
page | The number of the page you want to browse. Can be used by adding |
include | Enrich the API with more data and/or nested includes. Can be used by adding |
Endpoint details |
Authorization | API Key |
Pagination | NO |
Allowed nested includes | 10 |
Available parameters |
include | Enrich the API with more data and/or nested includes. Can be used by adding |
bookmakers | Filter on a list of bookmaker id's separated by comma. Can be used by adding |
markets | Filter on a list of market id's separated by comma. Can be used by adding |
Field | Description |
| Opens an array of data you've requested |
| A unique league id |
| Indicates if the league is active or not. Possible values are 'true' or 'false' |
|
| This was for our API version 1.0. It's only of use for old users of our API |
| The unique country id the league is played in |
| The logo URL path of the league |
| The name of the league |
| Indicates if the league is a cup or not. Possible values are 'true' or 'false' |
| The unique id of the current season |
| The unique id of the current round |
| The unique id of the current stage |
| Indicates if the league covers live standings |
| Opens an array of partial coverage for the league |
| Indicates if the league covers predictions |
| Indicates if the league covers goal topscorers |
| Indicates if the league covers assists topscorers |
| Indicates if the league covers cards topscorers |
Field | Description |
| Opens an array of data you've requested |
| A unique league id |
| Indicates if the league is active or not. Possible values are 'true' or 'false' |
|
| This was for our API version 1.0. It's only of use for old users of our API |
| The unique country id the league is played in |
| The logo URL path of the league |
| The name of the league |
| Indicates if the league is a cup or not. Possible values are 'true' or 'false' |
| The unique id of the current season |
| The unique id of the current round |
| The unique id of the current stage |
| Indicates if the league covers live standings |
| Opens an array of partial coverage for the league |
| Indicates if the league covers predictions |
| Indicates if the league covers goal topscorers |
| Indicates if the league covers assists topscorers |
| Indicates if the league covers cards topscorers |
Field | Description |
| Opens an array of data you've requested |
| A unique fixture id |
| The unique id of the league the fixture belongs to |
| The unique id of the season the fixture belongs to |
| The unique id of the stage the fixture belongs to |
| The unique id of the round the fixture belongs to |
| The unique id of the group the fixture belongs to |
| Indicates if the fixture has an aggregated score |
| The unique id of the venue the fixture is played at |
| The unique id of the referee that is in charge of the fixture |
| The unique id of the local team |
| The unique id of the visitor team |
| Contains the id of the team that won the fixture |
|
| Indicates if this fixture has commentaries available |
| Give information about the visitor attendance of the fixture |
|
| Optional additional information. |
| Indicates if the fixture was played at a neutral fixture. This often happens in cup finals |
|
| Opens an array containing the scores of the fixture |
| The number of goals the local team has scored in this fixture |
| The number of goals the visitor team has scored in this fixture |
| The number of penalty goals the local team has scored in this fixture (only available when the fixture goes into penalty shootout) |
| The number of penalty goals the visitor team has scored in this fixture (only available when the fixture goes into penalty shootout) |
| The score at halftime |
| The score at full time (90 minutes) |
| The score in extra time (only available when the fixture goes into extra time) |
| The score of the penalty shootout (only available when the fixture goes into penalty shootout) |
| Opens an array containing the time details of the fixture |
|
| Opens an array containing the time details of the fixture |
| Gives the date and time the fixture starts |
| Gives the date on which the fixture is played |
| Gives the starting time of the fixture |
| The timestamp notation of the match |
| Indicates in which timezone you've requested the data |
| Indicates in which minute the fixture is in |
| Indicates in which second the fixture is in |
| Indicates how much added time is added |
| Extra minute is when a fixture goes to extra time. Extra_minute will count from 0 to 15 and from 15 to 30. |
| In case of added time, it will end up in injury_minute |
| Opens an array containing the unique id's of the coaches |
| The unique id of the coach from the local team |
| The unique id of the coach from the visitor team |
| Opens an array containing the standings of the local- and visitor team |
| Indicates in which positions the local team is before the fixture |
| Indicates in which positions the visitor team is before the fixture |
| Opens an array containing the unique id's of the assistant referees |
| The unique id of the first assistant |
| The unique id of the second assistant |
| The unique id of the fourth official |
| Indicates in how many legs this fixture is played |
| Opens an array containing information about the team colors |
| Opens an array containing information about the local team colors |
| The main color code of the local team |
| The kit color codes of the local team |
| Opens an array containing information about the visitor team colors |
| The main color code of the visitor team |
| The kit color codes of the local team |
|
| This property indicates if the resource is used to display dummy data. The false of this property will always be a |
Endpoint details |
Authorization | API Key |
Pagination | NO |
Allowed nested includes | 2 |
Available parameters |
include | Enrich the API with more data and/or nested includes. Can be used by adding |
Endpoint details |
Authorization | API Key |
Pagination | NO |
Allowed nested includes | 4 |
Available parameters |
include | Enrich the API with more data and/or nested includes. Can be used by adding |
Field | Description |
| Opens an array of data you've requested |
| The unique season id |
| The name of the season |
| The unique league id the season belongs to |
| Indicates if the season is the current one. Possible values are "true" or "false" |
| The unique id of the current round |
| The unique id of the current stage |
To help you keep your data in sync we have implemented an endpoint that returns you all the games that have received updates within 2 hours ago. this will also imply games that have an updated lineup,
GET
Last Updated FixtureslocalTeam
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
news
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:
GET
Fixtures by Date Range for TeamlocalTeam
visitorTeam
substitutions
goals
cards
other
events
corners
lineup
bench
sidelined
comments
tvstations
highlights
round
stage
referee
venue
odds
inplayOdds
flatOdds
localCoach
visitorCoach
group
trends
firstAssistant
secondAssistant
fourthOfficial
stats
shootout
league
stats
probability
valuebet
news
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:
GET
Fixtures by Multiple ID'slocalTeam
visitorTeam
substitutions
goals
cards
other
events
corners
lineup
bench
sidelined
comments
tvstations
highlights
round
stage
referee
venue
odds
inplayOdds
flatOdds
localCoach
visitorCoach
group
trends
firstAssistant
secondAssistant
fourthOfficial
stats
shootout
league
stats
probability
valuebet
news
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:
GET
Fixtures by Date RangelocalTeam
visitorTeam
substitutions
goals
cards
other
events
corners
lineup
bench
sidelined
comments
tvstations
highlights
round
stage
referee
venue
odds
inplayOdds
flatOdds
localCoach
visitorCoach
group
trends
firstAssistant
secondAssistant
fourthOfficial
stats
shootout
league
stats
probability
valuebet
news
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:
GET
Fixtures by DatelocalTeam
visitorTeam
substitutions
goals
cards
other
events
corners
lineup
bench
sidelined
comments
tvstations
highlights
round
stage
referee
venue
odds
inplayOdds
flatOdds
localCoach
visitorCoach
group
trends
firstAssistant
secondAssistant
fourthOfficial
stats
shootout
league
stats
probability
valuebet
news
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:
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 livescores endpoint, the fixtures will be available 15 minutes before the match has started and 15 mins after it has ended.
Statistics can be retrieved by using adding &include=stats
to your request URL. This include is available on multiple endpoints. For more in-depth information, you can use our and .
At Sportmonks we have a lot of data, and you will find everything you need. The data is divided into match-, team-, season, player- and in-play (live) player statistics.
In the tutorial below, we will go through every option one by one.
GET
News of all fixturesWe have news available for all upcoming English Premier League and Champions League matches as well as limited coverage for French Ligue 1, German Bundesliga, Italy Serie A and Spanish La Liga.
Please note that you can also use the news
include on our fixtures and livescores endpoints.
fixtures
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:
GET
All LivescoreslocalTeam
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
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:
Use our Sportmonks Football News API to give an extra dimension to your application. Our News API has previews available for all upcoming English Premier League matches and EURO 2024.
GET
News of all upcoming fixturesWe have news available for all upcoming English Premier League and Champions League matches as well as limited coverage for French Ligue 1, German Bundesliga, Italy Serie A and Spanish La Liga.
fixtures
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:
Please note that you can also use the news
include on our fixtures and livescores endpoints.
GET
All Inplay LivescoreslocalTeam
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
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:
GET
News of all fixturesWe have news available for all upcoming English Premier League and Champions League matches as well as limited coverage for French Ligue 1, German Bundesliga, Italy Serie A and Spanish La Liga.
fixtures
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:
Please note that you can also use the news
include on our fixtures and livescores endpoints.
Indicates what kind of league this is. Possible values: 'domestic', 'cup', 'international'. More values can be found
Indicates what kind of league this is. Possible values: 'domestic', 'cup', 'international'. More values can be found
Opens an array of weather details. Possible values of the data in this array can be found in our
Gives information about the pitch. Possible values can be found in our
Opens an array containing the lineup formations of the teams. Possible values can be found in our
Indicates in which phase the fixture is in. Possible values can be found in our
Indicates if the team was deleted. More information:
Check this endpoint in Postman.
Check this endpoint in Postman.
Endpoint details
Authorization
API Key
Pagination
YES
Allowed nested includes
3
Available parameters
page
The number of the page you want to browse. Can be used by adding &page=
etc to your request url.
include
Enrich the API with more data and/or nested includes. Can be used by adding &include=
etc to your request url.
fixtures
Filter on a list of fixture id's separated by comma. Can be used by adding &fixtures=
etc to your request url.
bookmakers
Filter on a list of bookmaker id's separated by comma. Can be used by adding &bookmakers=
etc to your request url.
markets
Filter on a list of market id's separated by comma. Can be used by adding &markets=
etc to your request url.
leagues
Filter on a list of league id's separated by comma. Can be used by adding &leagues=
etc to your request url.
status
Filter fixtures based on a comma separated list of status codes as defined in the "Statuses & Definitions" documentation page. Can be used by adding &status=
etc to your request url.
timestamp
Add a unix timestamp to only receive the fixtures that have received an updated after this value.
Field
Description
data
Opens an array of data you've requested
id
A unique fixture id
league_id
The unique id of the league the fixture belongs to
season_id
The unique id of the season the fixture belongs to
stage_id
The unique id of the stage the fixture belongs to
round_id
The unique id of the round the fixture belongs to
group_id
The unique id of the group the fixture belongs to
aggregate_id
Indicates if the fixture has an aggregated score
venue_id
The unique id of the venue the fixture is played at
referee_id
The unique id of the referee that is in charge of the fixture
localteam_id
The unique id of the local team
visitorteam_id
The unique id of the visitor team
winnerteam_id
Contains the id of the team that won the fixture
weather_report
Opens an array of weather details. Possible values of the data in this array can be found in our statuses and definitions
commentaries
Indicates if this fixture has commentaries available
attendance
Give information about the visitor attendance of the fixture
pitch
Gives information about the pitch. Possible values can be found in our statuses and definitions
details
Optional additional information.
neutral_venue
Indicates if the fixture was played at a neutral fixture. This often happens in cup finals
formations
Opens an array containing the lineup formations of the teams. Possible values can be found in our statuses and definitions
scores
Opens an array containing the scores of the fixture
localteam_score
The number of goals the local team has scored in this fixture
visitorteam_score
The number of goals the visitor team has scored in this fixture
localteam_pen_score
The number of penalty goals the local team has scored in this fixture (only available when the fixture goes into penalty shootout)
visitorteam_pen_score
The number of penalty goals the visitor team has scored in this fixture (only available when the fixture goes into penalty shootout)
ht_score
The score at halftime
ft_score
The score at full time (90 minutes)
et_score
The score in extra time (only available when the fixture goes into extra time)
ps_score
The score of the penalty shootout (only available when the fixture goes into penalty shootout)
time
Opens an array containing the time details of the fixture
status
Indicates in which phase the fixture is in. Possible values can be found in our statuses and definitions
starting_at
Opens an array containing the time details of the fixture
date_time
Gives the date and time the fixture starts
date
Gives the date on which the fixture is played
time
Gives the starting time of the fixture
timestamp
The timestamp notation of the match
timezone
Indicates in which timezone you've requested the data
minute
Indicates in which minute the fixture is in
second
Indicates in which second the fixture is in
added_time
Indicates how much added time is added
extra_minute
Extra minute is when a fixture goes to extra time. Extra_minute will count from 0 to 15 and from 15 to 30.
injury_time
In case of added time, it will end up in injury_minute
coaches
Opens an array containing the unique id's of the coaches
localteam_coach_id
The unique id of the coach from the local team
visitorteam_coach_id
The unique id of the coach from the visitor team
standings
Opens an array containing the standings of the local- and visitor team
localteam_position
Indicates in which positions the local team is before the fixture
visitorteam_position
Indicates in which positions the visitor team is before the fixture
assistants
Opens an array containing the unique id's of the assistant referees
first_assistant_id
The unique id of the first assistant
second_assistant_id
The unique id of the second assistant
fourth_official_id
The unique id of the fourth official
leg
Indicates in how many legs this fixture is played
colors
Opens an array containing information about the team colors
localteam
Opens an array containing information about the local team colors
color
The main color code of the local team
kit_colors
The kit color codes of the local team
visitorteam
Opens an array containing information about the visitor team colors
color
The main color code of the visitor team
kit_colors
The kit color codes of the local team
deleted
Indicates if the team was deleted. More information: Keep in Sync
is_placeholder
This property indicates if the resource is used to display dummy data. The false of this property will always be a boolean
value.
Endpoint details
Authorization
API Key
Pagination
YES
Allowed nested includes
10
Available parameters
page
The number of the page you want to browse. Can be used by adding &page=
etc to your request url.
include
Enrich the API with more data and/or nested includes. Can be used by adding &include=
etc to your request url.
fixtures
Filter on a list of fixture id's separated by comma. Can be used by adding &fixtures=
etc to your request url.
bookmakers
Filter on a list of bookmaker id's separated by comma. Can be used by adding &bookmakers=
etc to your request url.
markets
Filter on a list of market id's separated by comma. Can be used by adding &markets=
etc to your request url.
leagues
Filter on a list of league id's separated by comma. Can be used by adding &leagues=
etc to your request url.
status
Filter fixtures based on a comma separated list of status codes as defined in the "Statuses & Definitions" documentation page. Can be used by adding &status=
etc to your request url.
Field
Description
data
Opens an array of data you've requested
id
A unique fixture id
league_id
The unique id of the league the fixture belongs to
season_id
The unique id of the season the fixture belongs to
stage_id
The unique id of the stage the fixture belongs to
round_id
The unique id of the round the fixture belongs to
group_id
The unique id of the group the fixture belongs to
aggregate_id
Indicates if the fixture has an aggregated score
venue_id
The unique id of the venue the fixture is played at
referee_id
The unique id of the referee that is in charge of the fixture
localteam_id
The unique id of the local team
visitorteam_id
The unique id of the visitor team
winnerteam_id
Contains the id of the team that won the fixture
weather_report
Opens an array of weather details. Possible values of the data in this array can be found in our statuses and definitions
commentaries
Indicates if this fixture has commentaries available
attendance
Give information about the visitor attendance of the fixture
pitch
Gives information about the pitch. Possible values can be found in our statuses and definitions
details
Optional additional information.
neutral_venue
Indicates if the fixture was played at a neutral fixture. This often happens in cup finals
formations
Opens an array containing the lineup formations of the teams. Possible values can be found in our statuses and definitions
scores
Opens an array containing the scores of the fixture
localteam_score
The number of goals the local team has scored in this fixture
visitorteam_score
The number of goals the visitor team has scored in this fixture
localteam_pen_score
The number of penalty goals the local team has scored in this fixture (only available when the fixture goes into penalty shootout)
visitorteam_pen_score
The number of penalty goals the visitor team has scored in this fixture (only available when the fixture goes into penalty shootout)
ht_score
The score at halftime
ft_score
The score at full time (90 minutes)
et_score
The score in extra time (only available when the fixture goes into extra time)
ps_score
The score of the penalty shootout (only available when the fixture goes into penalty shootout)
time
Opens an array containing the time details of the fixture
status
Indicates in which phase the fixture is in. Possible values can be found in our statuses and definitions
starting_at
Opens an array containing the time details of the fixture
date_time
Gives the date and time the fixture starts
date
Gives the date on which the fixture is played
time
Gives the starting time of the fixture
timestamp
The timestamp notation of the match
timezone
Indicates in which timezone you've requested the data
minute
Indicates in which minute the fixture is in
second
Indicates in which second the fixture is in
added_time
Indicates how much added time is added
extra_minute
Extra minute is when a fixture goes to extra time. Extra_minute will count from 0 to 15 and from 15 to 30.
injury_time
In case of added time, it will end up in injury_minute
coaches
Opens an array containing the unique id's of the coaches
localteam_coach_id
The unique id of the coach from the local team
visitorteam_coach_id
The unique id of the coach from the visitor team
standings
Opens an array containing the standings of the local- and visitor team
localteam_position
Indicates in which positions the local team is before the fixture
visitorteam_position
Indicates in which positions the visitor team is before the fixture
assistants
Opens an array containing the unique id's of the assistant referees
first_assistant_id
The unique id of the first assistant
second_assistant_id
The unique id of the second assistant
fourth_official_id
The unique id of the fourth official
leg
Indicates in how many legs this fixture is played
colors
Opens an array containing information about the team colors
localteam
Opens an array containing information about the local team colors
color
The main color code of the local team
kit_colors
The kit color codes of the local team
visitorteam
Opens an array containing information about the visitor team colors
color
The main color code of the visitor team
kit_colors
The kit color codes of the local team
deleted
Indicates if the team was deleted. More information: Keep in Sync
is_placeholder
This property indicates if the resource is used to display dummy data. The false of this property will always be a boolean
value.
Field
Description
data
Opens an array of data you've requested
id
A unique fixture id
league_id
The unique id of the league the fixture belongs to
season_id
The unique id of the season the fixture belongs to
stage_id
The unique id of the stage the fixture belongs to
round_id
The unique id of the round the fixture belongs to
group_id
The unique id of the group the fixture belongs to
aggregate_id
Indicates if the fixture has an aggregated score
venue_id
The unique id of the venue the fixture is played at
referee_id
The unique id of the referee that is in charge of the fixture
localteam_id
The unique id of the local team
visitorteam_id
The unique id of the visitor team
winnerteam_id
Contains the id of the team that won the fixture
weather_report
Opens an array of weather details. Possible values of the data in this array can be found in our statuses and definitions
commentaries
Indicates if this fixture has commentaries available
attendance
Give information about the visitor attendance of the fixture
pitch
Gives information about the pitch. Possible values can be found in our statuses and definitions
details
Optional additional information.
neutral_venue
Indicates if the fixture was played at a neutral fixture. This often happens in cup finals
formations
Opens an array containing the lineup formations of the teams. Possible values can be found in our statuses and definitions
scores
Opens an array containing the scores of the fixture
localteam_score
The number of goals the local team has scored in this fixture
visitorteam_score
The number of goals the visitor team has scored in this fixture
localteam_pen_score
The number of penalty goals the local team has scored in this fixture (only available when the fixture goes into penalty shootout)
visitorteam_pen_score
The number of penalty goals the visitor team has scored in this fixture (only available when the fixture goes into penalty shootout)
ht_score
The score at halftime
ft_score
The score at full time (90 minutes)
et_score
The score in extra time (only available when the fixture goes into extra time)
ps_score
The score of the penalty shootout (only available when the fixture goes into penalty shootout)
time
Opens an array containing the time details of the fixture
status
Indicates in which phase the fixture is in. Possible values can be found in our statuses and definitions
starting_at
Opens an array containing the time details of the fixture
date_time
Gives the date and time the fixture starts
date
Gives the date on which the fixture is played
time
Gives the starting time of the fixture
timestamp
The timestamp notation of the match
timezone
Indicates in which timezone you've requested the data
minute
Indicates in which minute the fixture is in
second
Indicates in which second the fixture is in
added_time
Indicates how much added time is added
extra_minute
Extra minute is when a fixture goes to extra time. Extra_minute will count from 0 to 15 and from 15 to 30.
injury_time
In case of added time, it will end up in injury_minute
coaches
Opens an array containing the unique id's of the coaches
localteam_coach_id
The unique id of the coach from the local team
visitorteam_coach_id
The unique id of the coach from the visitor team
standings
Opens an array containing the standings of the local- and visitor team
localteam_position
Indicates in which positions the local team is before the fixture
visitorteam_position
Indicates in which positions the visitor team is before the fixture
assistants
Opens an array containing the unique id's of the assistant referees
first_assistant_id
The unique id of the first assistant
second_assistant_id
The unique id of the second assistant
fourth_official_id
The unique id of the fourth official
leg
Indicates in how many legs this fixture is played
colors
Opens an array containing information about the team colors
localteam
Opens an array containing information about the local team colors
color
The main color code of the local team
kit_colors
The kit color codes of the local team
visitorteam
Opens an array containing information about the visitor team colors
color
The main color code of the visitor team
kit_colors
The kit color codes of the local team
deleted
Indicates if the team was deleted. More information: Keep in Sync
is_placeholder
This property indicates if the resource is used to display dummy data. The false of this property will always be a boolean
value.
Endpoint details
Authorization
API Key
Pagination
YES
Allowed nested includes
10
Available parameters
page
The number of the page you want to browse. Can be used by adding &page=
etc to your request url.
include
Enrich the API with more data and/or nested includes. Can be used by adding &include=
etc to your request url.
fixtures
Filter on a list of fixture id's separated by comma. Can be used by adding &fixtures=
etc to your request url.
bookmakers
Filter on a list of bookmaker id's separated by comma. Can be used by adding &bookmakers=
etc to your request url.
markets
Filter on a list of market id's separated by comma. Can be used by adding &markets=
etc to your request url.
leagues
Filter on a list of league id's separated by comma. Can be used by adding &leagues=
etc to your request url.
status
Filter fixtures based on a comma separated list of status codes as defined in the "Statuses & Definitions" documentation page. Can be used by adding &status=
etc to your request url.
Field
Description
data
Opens an array of data you've requested
id
A unique fixture id
league_id
The unique id of the league the fixture belongs to
season_id
The unique id of the season the fixture belongs to
stage_id
The unique id of the stage the fixture belongs to
round_id
The unique id of the round the fixture belongs to
group_id
The unique id of the group the fixture belongs to
aggregate_id
Indicates if the fixture has an aggregated score
venue_id
The unique id of the venue the fixture is played at
referee_id
The unique id of the referee that is in charge of the fixture
localteam_id
The unique id of the local team
visitorteam_id
The unique id of the visitor team
winnerteam_id
Contains the id of the team that won the fixture
weather_report
Opens an array of weather details. Possible values of the data in this array can be found in our statuses and definitions
commentaries
Indicates if this fixture has commentaries available
attendance
Give information about the visitor attendance of the fixture
pitch
Gives information about the pitch. Possible values can be found in our statuses and definitions
details
Optional additional information.
neutral_venue
Indicates if the fixture was played at a neutral fixture. This often happens in cup finals
formations
Opens an array containing the lineup formations of the teams. Possible values can be found in our statuses and definitions
scores
Opens an array containing the scores of the fixture
localteam_score
The number of goals the local team has scored in this fixture
visitorteam_score
The number of goals the visitor team has scored in this fixture
localteam_pen_score
The number of penalty goals the local team has scored in this fixture (only available when the fixture goes into penalty shootout)
visitorteam_pen_score
The number of penalty goals the visitor team has scored in this fixture (only available when the fixture goes into penalty shootout)
ht_score
The score at halftime
ft_score
The score at full time (90 minutes)
et_score
The score in extra time (only available when the fixture goes into extra time)
ps_score
The score of the penalty shootout (only available when the fixture goes into penalty shootout)
time
Opens an array containing the time details of the fixture
status
Indicates in which phase the fixture is in. Possible values can be found in our statuses and definitions
starting_at
Opens an array containing the time details of the fixture
date_time
Gives the date and time the fixture starts
date
Gives the date on which the fixture is played
time
Gives the starting time of the fixture
timestamp
The timestamp notation of the match
timezone
Indicates in which timezone you've requested the data
minute
Indicates in which minute the fixture is in
second
Indicates in which second the fixture is in
added_time
Indicates how much added time is added
extra_minute
Extra minute is when a fixture goes to extra time. Extra_minute will count from 0 to 15 and from 15 to 30.
injury_time
In case of added time, it will end up in injury_minute
coaches
Opens an array containing the unique id's of the coaches
localteam_coach_id
The unique id of the coach from the local team
visitorteam_coach_id
The unique id of the coach from the visitor team
standings
Opens an array containing the standings of the local- and visitor team
localteam_position
Indicates in which positions the local team is before the fixture
visitorteam_position
Indicates in which positions the visitor team is before the fixture
assistants
Opens an array containing the unique id's of the assistant referees
first_assistant_id
The unique id of the first assistant
second_assistant_id
The unique id of the second assistant
fourth_official_id
The unique id of the fourth official
leg
Indicates in how many legs this fixture is played
colors
Opens an array containing information about the team colors
localteam
Opens an array containing information about the local team colors
color
The main color code of the local team
kit_colors
The kit color codes of the local team
visitorteam
Opens an array containing information about the visitor team colors
color
The main color code of the visitor team
kit_colors
The kit color codes of the local team
deleted
Indicates if the team was deleted. More information: Keep in Sync
is_placeholder
This property indicates if the resource is used to display dummy data. The false of this property will always be a boolean
value.
Field
Description
data
Opens an array of data you've requested
id
A unique fixture id
league_id
The unique id of the league the fixture belongs to
season_id
The unique id of the season the fixture belongs to
stage_id
The unique id of the stage the fixture belongs to
round_id
The unique id of the round the fixture belongs to
group_id
The unique id of the group the fixture belongs to
aggregate_id
Indicates if the fixture has an aggregated score
venue_id
The unique id of the venue the fixture is played at
referee_id
The unique id of the referee that is in charge of the fixture
localteam_id
The unique id of the local team
visitorteam_id
The unique id of the visitor team
winnerteam_id
Contains the id of the team that won the fixture
weather_report
Opens an array of weather details. Possible values of the data in this array can be found in our statuses and definitions
commentaries
Indicates if this fixture has commentaries available
attendance
Give information about the visitor attendance of the fixture
pitch
Gives information about the pitch. Possible values can be found in our statuses and definitions
details
Optional additional information.
neutral_venue
Indicates if the fixture was played at a neutral fixture. This often happens in cup finals
formations
Opens an array containing the lineup formations of the teams. Possible values can be found in our statuses and definitions
scores
Opens an array containing the scores of the fixture
localteam_score
The number of goals the local team has scored in this fixture
visitorteam_score
The number of goals the visitor team has scored in this fixture
localteam_pen_score
The number of penalty goals the local team has scored in this fixture (only available when the fixture goes into penalty shootout)
visitorteam_pen_score
The number of penalty goals the visitor team has scored in this fixture (only available when the fixture goes into penalty shootout)
ht_score
The score at halftime
ft_score
The score at full time (90 minutes)
et_score
The score in extra time (only available when the fixture goes into extra time)
ps_score
The score of the penalty shootout (only available when the fixture goes into penalty shootout)
time
Opens an array containing the time details of the fixture
status
Indicates in which phase the fixture is in. Possible values can be found in our statuses and definitions
starting_at
Opens an array containing the time details of the fixture
date_time
Gives the date and time the fixture starts
date
Gives the date on which the fixture is played
time
Gives the starting time of the fixture
timestamp
The timestamp notation of the match
timezone
Indicates in which timezone you've requested the data
minute
Indicates in which minute the fixture is in
second
Indicates in which second the fixture is in
added_time
Indicates how much added time is added
extra_minute
Extra minute is when a fixture goes to extra time. Extra_minute will count from 0 to 15 and from 15 to 30.
injury_time
In case of added time, it will end up in injury_minute
coaches
Opens an array containing the unique id's of the coaches
localteam_coach_id
The unique id of the coach from the local team
visitorteam_coach_id
The unique id of the coach from the visitor team
standings
Opens an array containing the standings of the local- and visitor team
localteam_position
Indicates in which positions the local team is before the fixture
visitorteam_position
Indicates in which positions the visitor team is before the fixture
assistants
Opens an array containing the unique id's of the assistant referees
first_assistant_id
The unique id of the first assistant
second_assistant_id
The unique id of the second assistant
fourth_official_id
The unique id of the fourth official
leg
Indicates in how many legs this fixture is played
colors
Opens an array containing information about the team colors
localteam
Opens an array containing information about the local team colors
color
The main color code of the local team
kit_colors
The kit color codes of the local team
visitorteam
Opens an array containing information about the visitor team colors
color
The main color code of the visitor team
kit_colors
The kit color codes of the local team
deleted
Indicates if the team was deleted. More information: Keep in Sync
is_placeholder
This property indicates if the resource is used to display dummy data. The false of this property will always be a boolean
value.
Endpoint details
Authorization
API Key
Pagination
YES
Allowed nested includes
10
Available parameters
page
The number of the page you want to browse. Can be used by adding &page=
etc to your request url.
include
Enrich the API with more data and/or nested includes. Can be used by adding &include=
etc to your request url.
fixtures
Filter on a list of fixture id's separated by comma. Can be used by adding &fixtures=
etc to your request url.
bookmakers
Filter on a list of bookmaker id's separated by comma. Can be used by adding &bookmakers=
etc to your request url.
markets
Filter on a list of market id's separated by comma. Can be used by adding &markets=
etc to your request url.
leagues
Filter on a list of league id's separated by comma. Can be used by adding &leagues=
etc to your request url.
status
Filter fixtures based on a comma separated list of status codes as defined in the "Statuses & Definitions" documentation page. Can be used by adding &status=
etc to your request url.
Field
Description
data
Opens an array of data you've requested
id
A unique fixture id
league_id
The unique id of the league the fixture belongs to
season_id
The unique id of the season the fixture belongs to
stage_id
The unique id of the stage the fixture belongs to
round_id
The unique id of the round the fixture belongs to
group_id
The unique id of the group the fixture belongs to
aggregate_id
Indicates if the fixture has an aggregated score
venue_id
The unique id of the venue the fixture is played at
referee_id
The unique id of the referee that is in charge of the fixture
localteam_id
The unique id of the local team
visitorteam_id
The unique id of the visitor team
winnerteam_id
Contains the id of the team that won the fixture
weather_report
Opens an array of weather details. Possible values of the data in this array can be found in our statuses and definitions
commentaries
Indicates if this fixture has commentaries available
attendance
Give information about the visitor attendance of the fixture
pitch
Gives information about the pitch. Possible values can be found in our statuses and definitions
details
Optional additional information.
neutral_venue
Indicates if the fixture was played at a neutral fixture. This often happens in cup finals
formations
Opens an array containing the lineup formations of the teams. Possible values can be found in our statuses and definitions
scores
Opens an array containing the scores of the fixture
localteam_score
The number of goals the local team has scored in this fixture
visitorteam_score
The number of goals the visitor team has scored in this fixture
localteam_pen_score
The number of penalty goals the local team has scored in this fixture (only available when the fixture goes into penalty shootout)
visitorteam_pen_score
The number of penalty goals the visitor team has scored in this fixture (only available when the fixture goes into penalty shootout)
ht_score
The score at halftime
ft_score
The score at full time (90 minutes)
et_score
The score in extra time (only available when the fixture goes into extra time)
ps_score
The score of the penalty shootout (only available when the fixture goes into penalty shootout)
time
Opens an array containing the time details of the fixture
status
Indicates in which phase the fixture is in. Possible values can be found in our statuses and definitions
starting_at
Opens an array containing the time details of the fixture
date_time
Gives the date and time the fixture starts
date
Gives the date on which the fixture is played
time
Gives the starting time of the fixture
timestamp
The timestamp notation of the match
timezone
Indicates in which timezone you've requested the data
minute
Indicates in which minute the fixture is in
second
Indicates in which second the fixture is in
added_time
Indicates how much added time is added
extra_minute
Extra minute is when a fixture goes to extra time. Extra_minute will count from 0 to 15 and from 15 to 30.
injury_time
In case of added time, it will end up in injury_minute
coaches
Opens an array containing the unique id's of the coaches
localteam_coach_id
The unique id of the coach from the local team
visitorteam_coach_id
The unique id of the coach from the visitor team
standings
Opens an array containing the standings of the local- and visitor team
localteam_position
Indicates in which positions the local team is before the fixture
visitorteam_position
Indicates in which positions the visitor team is before the fixture
assistants
Opens an array containing the unique id's of the assistant referees
first_assistant_id
The unique id of the first assistant
second_assistant_id
The unique id of the second assistant
fourth_official_id
The unique id of the fourth official
leg
Indicates in how many legs this fixture is played
colors
Opens an array containing information about the team colors
localteam
Opens an array containing information about the local team colors
color
The main color code of the local team
kit_colors
The kit color codes of the local team
visitorteam
Opens an array containing information about the visitor team colors
color
The main color code of the visitor team
kit_colors
The kit color codes of the local team
deleted
Indicates if the team was deleted. More information: Keep in Sync
is_placeholder
This property indicates if the resource is used to display dummy data. The false of this property will always be a boolean
value.
Endpoint details |
Authorization | API Key |
Pagination | YES |
Allowed nested includes | 10 |
Available parameters |
page | The number of the page you want to browse. Can be used by adding |
include | Enrich the API with more data and/or nested includes. Can be used by adding |
fixtures | Filter on a list of fixture id's separated by comma. Can be used by adding |
bookmakers | Filter on a list of bookmaker id's separated by comma. Can be used by adding |
markets | Filter on a list of market id's separated by comma. Can be used by adding |
leagues | Filter on a list of league id's separated by comma. Can be used by adding |
Endpoint details |
Authorization | API Key |
Pagination | YES |
Allowed nested includes | 10 |
Available parameters |
page | The number of the page you want to browse. Can be used by adding |
include | Enrich the API with more data and/or nested includes. Can be used by adding |
fixtures | Filter on a list of fixture id's separated by comma. Can be used by adding |
bookmakers | Filter on a list of bookmaker id's separated by comma. Can be used by adding |
markets | Filter on a list of market id's separated by comma. Can be used by adding |
leagues | Filter on a list of league id's separated by comma. Can be used by adding |
Endpoint details
Authorization
API Key
Pagination
NO
Allowed nested includes
10
Available parameters
include
Enrich the API with more data and/or nested includes. Can be used by adding &include=
etc to your request url.
Endpoint details
Authorization
API Key
Pagination
NO
Endpoint details |
Authorization | API Key |
Pagination | YES |
Allowed nested includes | 10 |
Available parameters |
include | Enrich the API with more data and/or nested includes. Can be used by adding |
Endpoint details |
Authorization | API Key |
Pagination | YES |
Allowed nested includes | 10 |
Available parameters |
include | Enrich the API with more data and/or nested includes. Can be used by adding |
Endpoint details |
Authorization | API Key |
Pagination | YES |
Allowed nested includes | 10 |
Available parameters |
include | Enrich the API with more data and/or nested includes. Can be used by adding |
Field | Description |
| Opens an array of data you've requested |
| A unique fixture id |
| The unique id of the league the fixture belongs to |
| The unique id of the season the fixture belongs to |
| The unique id of the stage the fixture belongs to |
| The unique id of the round the fixture belongs to |
| The unique id of the group the fixture belongs to |
| Indicates if the fixture has an aggregated score |
| The unique id of the venue the fixture is played at |
| The unique id of the referee that is in charge of the fixture |
| The unique id of the local team |
| The unique id of the visitor team |
| Contains the id of the team that won the fixture |
|
| Indicates if this fixture has commentaries available |
| Give information about the visitor attendance of the fixture |
|
| Optional additional information. |
| Indicates if the fixture was played at a neutral fixture. This often happens in cup finals |
|
| Opens an array containing the scores of the fixture |
| The number of goals the local team has scored in this fixture |
| The number of goals the visitor team has scored in this fixture |
| The number of penalty goals the local team has scored in this fixture (only available when the fixture goes into penalty shootout) |
| The number of penalty goals the visitor team has scored in this fixture (only available when the fixture goes into penalty shootout) |
| The score at halftime |
| The score at full time (90 minutes) |
| The score in extra time (only available when the fixture goes into extra time) |
| The score of the penalty shootout (only available when the fixture goes into penalty shootout) |
| Opens an array containing the time details of the fixture |
|
| Opens an array containing the time details of the fixture |
| Gives the date and time the fixture starts |
| Gives the date on which the fixture is played |
| Gives the starting time of the fixture |
| The timestamp notation of the match |
| Indicates in which timezone you've requested the data |
| Indicates in which minute the fixture is in |
| Indicates in which second the fixture is in |
| Indicates how much added time is added |
| Extra minute is when a fixture goes to extra time. Extra_minute will count from 0 to 15 and from 15 to 30. |
| In case of added time, it will end up in injury_minute |
| Opens an array containing the unique id's of the coaches |
| The unique id of the coach from the local team |
| The unique id of the coach from the visitor team |
| Opens an array containing the standings of the local- and visitor team |
| Indicates in which positions the local team is before the fixture |
| Indicates in which positions the visitor team is before the fixture |
| Opens an array containing the unique id's of the assistant referees |
| The unique id of the first assistant |
| The unique id of the second assistant |
| The unique id of the fourth official |
| Indicates in how many legs this fixture is played |
| Opens an array containing information about the team colors |
| Opens an array containing information about the local team colors |
| The main color code of the local team |
| The kit color codes of the local team |
| Opens an array containing information about the visitor team colors |
| The main color code of the visitor team |
| The kit color codes of the local team |
|
| This property indicates if the resource is used to display dummy data. The false of this property will always be a |
Field | Description |
| Opens an array of data you've requested |
| A unique fixture id |
| The unique id of the league the fixture belongs to |
| The unique id of the season the fixture belongs to |
| The unique id of the stage the fixture belongs to |
| The unique id of the round the fixture belongs to |
| The unique id of the group the fixture belongs to |
| Indicates if the fixture has an aggregated score |
| The unique id of the venue the fixture is played at |
| The unique id of the referee that is in charge of the fixture |
| The unique id of the local team |
| The unique id of the visitor team |
| Contains the id of the team that won the fixture |
|
| Indicates if this fixture has commentaries available |
| Give information about the visitor attendance of the fixture |
|
| Optional additional information. |
| Indicates if the fixture was played at a neutral fixture. This often happens in cup finals |
|
| Opens an array containing the scores of the fixture |
| The number of goals the local team has scored in this fixture |
| The number of goals the visitor team has scored in this fixture |
| The number of penalty goals the local team has scored in this fixture (only available when the fixture goes into penalty shootout) |
| The number of penalty goals the visitor team has scored in this fixture (only available when the fixture goes into penalty shootout) |
| The score at halftime |
| The score at full time (90 minutes) |
| The score in extra time (only available when the fixture goes into extra time) |
| The score of the penalty shootout (only available when the fixture goes into penalty shootout) |
| Opens an array containing the time details of the fixture |
|
| Opens an array containing the time details of the fixture |
| Gives the date and time the fixture starts |
| Gives the date on which the fixture is played |
| Gives the starting time of the fixture |
| The timestamp notation of the match |
| Indicates in which timezone you've requested the data |
| Indicates in which minute the fixture is in |
| Indicates in which second the fixture is in |
| Indicates how much added time is added |
| Extra minute is when a fixture goes to extra time. Extra_minute will count from 0 to 15 and from 15 to 30. |
| In case of added time, it will end up in injury_minute |
| Opens an array containing the unique id's of the coaches |
| The unique id of the coach from the local team |
| The unique id of the coach from the visitor team |
| Opens an array containing the standings of the local- and visitor team |
| Indicates in which positions the local team is before the fixture |
| Indicates in which positions the visitor team is before the fixture |
| Opens an array containing the unique id's of the assistant referees |
| The unique id of the first assistant |
| The unique id of the second assistant |
| The unique id of the fourth official |
| Indicates in how many legs this fixture is played |
| Opens an array containing information about the team colors |
| Opens an array containing information about the local team colors |
| The main color code of the local team |
| The kit color codes of the local team |
| Opens an array containing information about the visitor team colors |
| The main color code of the visitor team |
| The kit color codes of the local team |
|
| This property indicates if the resource is used to display dummy data. The false of this property will always be a |
The Head 2 Head endpoint provides you all previous Games between two Teams. Because it is about Historical Fixtures, it is possible to add Includes like for example Events, Line-ups, Stats, Goals, Cards, Referee etc.
This Head 2 Head endpoint can give you a complete overview of the historical Games between two teams.
Get
Head2Head by Team IDslocalTeam
visitorTeam
substitutions
goals
cards
other
events
corners
lineup
bench
sidelined
comments
tvstations
highlights
round
stage
referee
venue
odds
inplayOdds
flatOdds
localCoach
visitorCoach
group
trends
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:
Standings represent the rankings of Teams in the different Leagues they participate in. Responses of the Standings endpoint can be returned in two formats, depending on the League setup. For ‘normal’ Leagues the response format is different compared to Cups.
If you have Cups and ‘normal’ Leagues in your plan, make sure you check out the response properly.
Check this endpoint in Postman.
GET
Standings by Season IDNote that includes on this endpoint must be prefixed by "standings."
team
league
season
round
stages
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:
Season Field Description
Standings Field Description
Live Standings represent the rankings of Teams in the different Leagues they participate in real-time. So if a Game is currently being played, the Live Standing returns the correct Live Standing based
With this endpoint you are able to retreive the standings for a given round. It will calculate the games played up untill the given round id and provide a standings result for it.
With this endpoint you are able to retrieve the standings at a given date(time). It will calculate the games played up untill the given date/time and provides a standings result for it.
Opens an array of weather details. Possible values of the data in this array can be found in our
Gives information about the pitch. Possible values can be found in our
Opens an array containing the lineup formations of the teams. Possible values can be found in our
Indicates in which phase the fixture is in. Possible values can be found in our
Indicates if the team was deleted. More information:
Opens an array of weather details. Possible values of the data in this array can be found in our
Gives information about the pitch. Possible values can be found in our
Opens an array containing the lineup formations of the teams. Possible values can be found in our
Indicates in which phase the fixture is in. Possible values can be found in our
Indicates if the team was deleted. More information:
Check this endpoint in Postman.
Field
Description
data
Opens an array of data you've requested
id
A unique fixture id
league_id
The unique id of the league the fixture belongs to
season_id
The unique id of the season the fixture belongs to
stage_id
The unique id of the stage the fixture belongs to
round_id
The unique id of the round the fixture belongs to
group_id
The unique id of the group the fixture belongs to
aggregate_id
Indicates if the fixture has an aggregated score
venue_id
The unique id of the venue the fixture is played at
referee_id
The unique id of the referee that is in charge of the fixture
localteam_id
The unique id of the local team
visitorteam_id
The unique id of the visitor team
winnerteam_id
Contains the id of the team that won the fixture
weather_report
Opens an array of weather details. Possible values of the data in this array can be found in our statuses and definitions
commentaries
Indicates if this fixture has commentaries available
attendance
Give information about the visitor attendance of the fixture
pitch
Gives information about the pitch. Possible values can be found in our statuses and definitions
details
Optional additional information.
neutral_venue
Indicates if the fixture was played at a neutral fixture. This often happens in cup finals
formations
Opens an array containing the lineup formations of the teams. Possible values can be found in our statuses and definitions
scores
Opens an array containing the scores of the fixture
localteam_score
The number of goals the local team has scored in this fixture
visitorteam_score
The number of goals the visitor team has scored in this fixture
localteam_pen_score
The number of penalty goals the local team has scored in this fixture (only available when the fixture goes into penalty shootout)
visitorteam_pen_score
The number of penalty goals the visitor team has scored in this fixture (only available when the fixture goes into penalty shootout)
ht_score
The score at halftime
ft_score
The score at full time (90 minutes)
et_score
The score in extra time (only available when the fixture goes into extra time)
ps_score
The score of the penalty shootout (only available when the fixture goes into penalty shootout)
time
Opens an array containing the time details of the fixture
status
Indicates in which phase the fixture is in. Possible values can be found in our statuses and definitions
starting_at
Opens an array containing the time details of the fixture
date_time
Gives the date and time the fixture starts
date
Gives the date on which the fixture is played
time
Gives the starting time of the fixture
timestamp
The timestamp notation of the match
timezone
Indicates in which timezone you've requested the data
minute
Indicates in which minute the fixture is in
second
Indicates in which second the fixture is in
added_time
Indicates how much added time is added
extra_minute
Extra minute is when a fixture goes to extra time. Extra_minute will count from 0 to 15 and from 15 to 30.
injury_time
In case of added time, it will end up in injury_minute
coaches
Opens an array containing the unique id's of the coaches
localteam_coach_id
The unique id of the coach from the local team
visitorteam_coach_id
The unique id of the coach from the visitor team
standings
Opens an array containing the standings of the local- and visitor team
localteam_position
Indicates in which positions the local team is before the fixture
visitorteam_position
Indicates in which positions the visitor team is before the fixture
assistants
Opens an array containing the unique id's of the assistant referees
first_assistant_id
The unique id of the first assistant
second_assistant_id
The unique id of the second assistant
fourth_official_id
The unique id of the fourth official
leg
Indicates in how many legs this fixture is played
colors
Opens an array containing information about the team colors
localteam
Opens an array containing information about the local team colors
color
The main color code of the local team
kit_colors
The kit color codes of the local team
visitorteam
Opens an array containing information about the visitor team colors
color
The main color code of the visitor team
kit_colors
The kit color codes of the local team
deleted
Indicates if the team was deleted. More information: Keep in Sync
is_placeholder
This property indicates if the resource is used to display dummy data. The false of this property will always be a boolean
value.
Endpoint details
Authorization
API Key
Pagination
NO
Allowed nested includes
2
Available parameters
include
Enrich the API with more data and/or nested includes. Can be used by adding &include=
to your request url.
between
You can filter between dates: &between=
This gives you the opportunity to retrieve all past (or future) matches between two teams.
Field | Description |
| The unique id of the current stage |
| The name of the stage |
| The unique league id the stage belongs to |
| The unique id of the current season |
| The unique id of the current round |
| The name of the round |
| Indicates what kind of type this stage is |
| The unique id of the current stage |
| The name of the stage |
Field | Description |
| The actual position in the rankings in the stage |
| The unique team id of the team in that position in the stage |
| The team name in that position in the stage |
| The unique id of the current round |
| The name of the round |
| The unique id of the group, in which the team participates in |
| The name of the group, in which the team participates in |
| The overall results of the team, i.e., the number of games, points and goals |
| The home results of the team, i.e., the number of games, points and goals |
| The away results of the team, i.e., the number of games, points and goals |
| The total points of the team and their goal difference |
| The standing rules of the place the team is in |
| The accumulated number of points the team has |
| The recent form of the team |
| Will be available in API 3.0: Indicates if the team moves up on down based on the last standings. |
Field | Description |
| The actual position in the rankings in the stage |
| The unique team id of the team in that position in the stage |
| The team name in that position in the stage |
| The unique id of the current round |
| The name of the round |
| The unique id of the group, in which the team participates in |
| The name of the group, in which the team participates in |
| The overall results of the team, i.e., the number of games, points and goals |
| The home results of the team, i.e., the number of games, points and goals |
| The away results of the team, i.e., the number of games, points and goals |
| The total points of the team and their goal difference |
| The standing rules of the place the team is in |
| The accumulated number of points the team has |
| The recent form of the team |
| Will be available in API 3.0: Indicates if the team moves up on down based on the last standings. |
Field | Description |
| The actual position in the rankings in the stage |
| The unique team id of the team in that position in the stage |
| The team name in that position in the stage |
| The unique id of the current round |
| The name of the round |
| The unique id of the group, in which the team participates in |
| The name of the group, in which the team participates in |
| The overall results of the team, i.e., the number of games, points and goals |
| The home results of the team, i.e., the number of games, points and goals |
| The away results of the team, i.e., the number of games, points and goals |
| The total points of the team and their goal difference |
| The standing rules of the place the team is in |
| The accumulated number of points the team has |
| The recent form of the team |
| Will be available in API 3.0: Indicates if the team moves up on down based on the last standings. |
Field | Description |
| The actual position in the rankings in the stage |
| The unique team id of the team in that position in the stage |
| The team name in that position in the stage |
| The unique id of the current round |
| The name of the round |
| The unique id of the group, in which the team participates in |
| The name of the group, in which the team participates in |
| The overall results of the team, i.e., the number of games, points and goals |
| The home results of the team, i.e., the number of games, points and goals |
| The away results of the team, i.e., the number of games, points and goals |
| The total points of the team and their goal difference |
| The standing rules of the place the team is in |
| The accumulated number of points the team has |
| The recent form of the team |
| Will be available in API 3.0: Indicates if the team moves up on down based on the last standings. |
Endpoint details
Authorization
API Key
Pagination
YES
Allowed nested includes
2
Endpoint details
Authorization
API Key
Pagination
NO
Allowed nested includes
0
Endpoint details |
Authorization | API Key |
Pagination | NO |
Allowed nested includes | 2 |
Available parameters |
include | Enrich the API with more data and/or nested includes. Can be used by adding |
stage_ids | A Comma separated list of stage ids. Can be used by adding |
group_ids | A Comma separated list of group ids. Can be used by adding |
Nothing is better than a good rivalry! Do you want to be able to show the biggest rivalries and the hottest derby days? Think about 'The Old Firm' or ‘The Superclásico’ and 'The Merseyside Derby'. With this new Rivals Endpoint you will be able to show all rivals every club has.
Please note that you can also use&include=rivals
on our teams endpoint.
Endpoint details |
Authorization | API Key |
Pagination | NO |
Allowed nested includes | 0 |
Available parameters |
group_id | One id of a group can be added to filter the tables. Can be used by adding |
Endpoint details |
Authorization | API Key |
Pagination | NO |
Allowed nested includes | 0 |
Endpoint details |
Authorization | API Key |
Pagination | NO |
Allowed nested includes | 0 |
GET
Team by IDcountry
squad
coach
transfers
sidelined
stats
venue
fifaranking
uefaranking
visitorFixtures
localFixtures
visitorResults
latest
upcoming
goalscorers
cardscorers
assistscorers
aggregatedGoalscorers
aggregatedCardscorers
aggregatedAssistscorers
league
activeSeasons
trophies
rivals
Please note that the squad include only returns the squad of the current domestic season.
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:
GET
Teams by Country IDcountry
squad
coach
transfers
sidelined
stats
venue
fifaranking
uefaranking
visitorFixtures
localFixtures
visitorResults
latest
upcoming
goalscorers
cardscorers
assistscorers
aggregatedGoalscorers
aggregatedCardscorers
aggregatedAssistscorers
league
activeSeasons
trophies
rivals
Please note that the squad include only returns the squad of the current domestic season.
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:
With the Teams endpoint you can find all Team Details you need. You can think of information about when the Team is founded, Logo, Team Name, Short Name etc.
But especially by using the right includes you can have the right Team details you need, like the Team Coach, Team Venues, Results, Upcoming Games, Team Stats and many more valuable Team details.
GET
Team by Season IDcountry
squad
coach
transfers
sidelined
stats
venue
fifaranking
uefaranking
visitorFixtures
localFixtures
visitorResults
latest
upcoming
country
squad
coach
transfers
sidelined
stats
venue
fifaranking
uefaranking
visitorFixtures
localFixtures
visitorResults
latest
upcoming
goalscorers
cardscorers
assistscorers
aggregatedGoalscorers
aggregatedCardscorers
aggregatedAssistscorers
trophies
rivals
Please note that the squad include only returns the squad of the current domestic season.
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:
This endpoint returns an array of Teams that meet your search criteria. Note that it will not return Teams that have never played any games that are not covered by your subscription plan.
GET
Search Team by Namecountry
squad
coach
transfers
sidelined
stats
venue
fifaranking
uefaranking
visitorFixtures
localFixtures
visitorResults
latest
upcoming
goalscorers
cardscorers
assistscorers
aggregatedGoalscorers
aggregatedCardscorers
aggregatedAssistscorers
league
activeSeasons
trophies
rivals
Please note that the squad include only returns the squad of the current domestic season.
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:
GET
Players by Country IDposition
team
stats
trophies
sidelined
transfers
lineups
country
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:
GET
Player by IDposition
team
stats
trophies
sidelined
transfers
lineups
country
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:
The Players endpoint provides you detailed Player information. With this endpoint you will be able to build complete Player Profiles.
By using for example the Stats
include it is possible to see the progression of the Player over the current domestic season. Those are also available for historic Seasons, starting from 2017.
The Topscorers endpoint provides you accurate information about the Topscorers in Goals, Cards and Assists. The endpoint returns the top 25 players and they can all be included at once or separately per Type (Goals, Cards or Assists).
This Topscorers endpoint returns the Topscorers by Stage of the Season. If you want an aggregated Topscorer list, please use the Aggregated Topscorers by Season endpoint.
Returns all the leagues/seasons a team ever participated in. This only relates to data that is covered by our API.
GET
Search Player by Nameposition
team
stats
trophies
sidelined
transfers
lineups
country
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:
This Topscorers endpoint returns the Aggregated Topscorers by Season. This means that all stages are summed, also preliminary stages.
GET
Topscorers Aggregated by season IDaggregatedGoalscorers.player
aggregatedGoalscorers.player.team
aggregatedCardscorers.player
aggregatedCardscorers.player.team
aggregatedAssistscorers.player
aggregatedAssistscorers.player.team
aggregatedGoalscorers.team
aggregatedCardscorers.team
aggregatedAssistscorers.team
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:
Season Field Description
Topscorers Field Description
Check this endpoint in Postman.
The Venue endpoint provides Venue information like Name, City, Capacity, Address and even a Venue image.
Check this endpoint in Postman.
GET
Rivals by Team IDcountry
squad
coach
transfers
sidelined
stats
venue
fifaranking
uefaranking
visitorFixtures
localFixtures
visitorResults
latest
upcoming
goalscorers
cardscorers
assistscorers
aggregatedGoalscorers
aggregatedCardscorers
aggregatedAssistscorers
league
activeSeasons
trophies
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:
GET
Topscorers by season IDgoalscorers.player.team
cardscorers.player.team
assistscorers.player.team
goalscorers.team
cardscorers.team
assistscorers.team
goalscorers.player
cardscorers.player
assistscorers.player
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:
Season Field Description
Topscorers Field Description
Check this endpoint in Postman.
Field
Description
id
The unique id of the team
legacy_id
This was for our API version 1.0. It's only of use for old users of our API
name
The name of the team
short_code
The short code of the team
twitter
The official twitter page of the team
country_id
The unique country id the team is from
national_team
Indicates if the team is a national team
founded
The year when the team was founded
logo_path
The logo URL path of the team logo
venue_id
The official venue of the team
current_season_id
The unique id of the season the team is active in
is_placeholder
Added a property on both fixture and team responses called is_placeholder
. This property indicates if the resource is used to display dummy data. The false of this property will always be a boolean
value.
Field
Description
id
The unique id of the team
legacy_id
This was for our API version 1.0. It's only of use for old users of our API
name
The name of the team
short_code
The short code of the team
twitter
The official twitter page of the team
country_id
The unique country id the team is from
national_team
Indicates if the team is a national team
founded
The year when the team was founded
logo_path
The logo URL path of the team logo
venue_id
The official venue of the team
current_season_id
The unique id of the season the team is active in
is_placeholder
Added a property on both fixture and team responses called is_placeholder
. This property indicates if the resource is used to display dummy data. The false of this property will always be a boolean
value.
Field
Description
id
The unique id of the team
legacy_id
This was for our API version 1.0. It's only of use for old users of our API
name
The name of the team
short_code
The short code of the team
twitter
The official twitter page of the team
country_id
The unique country id the team is from
national_team
Indicates if the team is a national team
founded
The year when the team was founded
logo_path
The logo URL path of the team logo
venue_id
The official venue of the team
current_season_id
The unique id of the season the team is active in
is_placeholder
Added a property on both fixture and team responses called is_placeholder
. This property indicates if the resource is used to display dummy data. The false of this property will always be a boolean
value.
Field
Description
data
Opens an array of data you've requested
id
A unique league id
active
Indicates if the league is active or not. Possible values are 'true' or 'false'
type
Indicates what kind of league this is. Possible values: 'domestic', 'cup', 'international'. More values can be found here
legacy_id
This was for our API version 1.0. It's only of use for old users of our API
country_id
The unique country id the league is played in
logo_path
The logo URL path of the league
name
The name of the league
is_cup
Indicates if the league is a cup or not. Possible values are 'true' or 'false'
current_season_id
The unique id of the current season
current_round_id
The unique id of the current round
current_stage_id
The unique id of the current stage
live_standings
Indicates if the league covers live standings
coverage
Opens an array of partial coverage for the league
predictions
Indicates if the league covers predictions
topscorers_goals
Indicates if the league covers goal topscorers
topscorers_assists
Indicates if the league covers assists topscorers
topscorers_cards
Indicates if the league covers cards topscorers
Field
Description
id
The unique id of the team
legacy_id
This was for our API version 1.0. It's only of use for old users of our API
name
The name of the team
short_code
The short code of the team
twitter
The official twitter page of the team
country_id
The unique country id the team is from
national_team
Indicates if the team is a national team
founded
The year when the team was founded
logo_path
The logo URL path of the team logo
venue_id
The official venue of the team
current_season_id
The unique id of the season the team is active in
is_placeholder
Added a property on both fixture and team responses called is_placeholder
. This property indicates if the resource is used to display dummy data. The false of this property will always be a boolean
value.
Field
Description
player_id
The unique id of the main player
team_id
The unique id of the team the player belongs to
country_id
The unique id of the country the player is from
position_id
The unique id of the position the player plays in
common_name
The common name the player is known for
display_name
The display name of the player. Often used to show in the lineup formation
fullname
The full name of the player
firstname
The first name of the player
lastname
The last name of the player
nationality
The nationality of the player
birthdate
The date of birth of the player
birthcountry
The country the player was born in
birthplace
The place the player was born in
height
The height of the player
weight
The weight of the player
image_path
The URL of the player image
Field
Description
data
Opens an array of data you've requested
id
A unique league id
active
Indicates if the league is active or not. Possible values are 'true' or 'false'
type
Indicates what kind of league this is. Possible values: 'domestic', 'cup', 'international'. More values can be found here
legacy_id
This was for our API version 1.0. It's only of use for old users of our API
country_id
The unique country id the league is played in
logo_path
The logo URL path of the league
name
The name of the league
is_cup
Indicates if the league is a cup or not. Possible values are 'true' or 'false'
current_season_id
The unique id of the current season
current_round_id
The unique id of the current round
current_stage_id
The unique id of the current stage
live_standings
Indicates if the league covers live standings
coverage
Opens an array of partial coverage for the league
predictions
Indicates if the league covers predictions
topscorers_goals
Indicates if the league covers goal topscorers
topscorers_assists
Indicates if the league covers assists topscorers
topscorers_cards
Indicates if the league covers cards topscorers
Field
Description
player_id
The unique id of the main player
team_id
The unique id of the team the player belongs to
country_id
The unique id of the country the player is from
position_id
The unique id of the position the player plays in
common_name
The common name the player is known for
display_name
The display name of the player. Often used to show in the lineup formation
fullname
The full name of the player
firstname
The first name of the player
lastname
The last name of the player
nationality
The nationality of the player
birthdate
The date of birth of the player
birthcountry
The country the player was born in
birthplace
The place the player was born in
height
The height of the player
weight
The weight of the player
image_path
The URL of the player image
Endpoint details
Authorization
API Key
Pagination
NO
Allowed nested includes
3
Available parameters
include
Enrich the API with more data and/or nested includes. Can be used by adding &include=
etc. to your request url.
seasons
Filter stats, topscorers (if included) based on a comma separated list of season ids. Can be used by adding &seasons=
etc. to your request url.
Endpoint details
Authorization
API Key
Pagination
NO
Allowed nested includes
3
Available parameters
include
Enrich the API with more data and/or nested includes. Can be used by adding &include=
etc. to your request url.
seasons
Filter stats, topscorers (if included) based on a comma separated list of season ids. Can be used by adding &seasons=
etc. to your request url.
Endpoint details
Authorization
API Key
Pagination
YES
Allowed nested includes
3
Available parameters
include
Enrich the API with more data and/or nested includes. Can be used by adding &include=
etc. to your request url.
seasons
Filter stats, topscorers (if included) based on a comma separated list of season ids. Can be used by adding &seasons=
etc. to your request url.
Endpoint details
Authorization
API Key
Pagination
NO
Allowed nested includes
2
Available parameters
include
Enrich the API with more data and/or nested includes. Can be used by adding &include=
etc. to your request url.
seasons
Filter stats, topscorers (if included) based on a comma separated list of season ids. Can be used by adding &seasons=
etc. to your request url.
Field | Description |
| The unique id of the current stage |
| The name of the stage |
| The unique league id the stage belongs to |
| The unique id of the current season |
| The unique id of the current round |
| The name of the round |
| Indicates what kind of type this stage is |
| The unique id of the current stage |
| The name of the stage |
Field | Description |
| The actual position in the rankings in the stage |
| The unique player id of the player in that position in the stage |
| The unique id of the the player plays for |
| The unique id of the current stage |
| The total number of goals the player has scored in the stage |
| The total number of penalty goals the player has scored in the stage |
| The type of the standings. Possible values are: goals, cards or assists |
Field | Description |
| The unique id of the team |
| This was for our API version 1.0. It's only of use for old users of our API |
| The name of the team |
| The short code of the team |
| The official twitter page of the team |
| The unique country id the team is from |
| Indicates if the team is a national team |
| The year when the team was founded |
| The logo URL path of the team logo |
| The official venue of the team |
| The unique id of the season the team is active in |
| Added a property on both fixture and team responses called |
Field | Description |
| The unique id of the current stage |
| The name of the stage |
| The unique league id the stage belongs to |
| The unique id of the current season |
| The unique id of the current round |
| The name of the round |
| Indicates what kind of type this stage is |
| The unique id of the current stage |
| The name of the stage |
Field | Description |
| The actual position in the rankings in the stage |
| The unique player id of the player in that position in the stage |
| The unique id of the the player plays for |
| The unique id of the current stage |
| The total number of goals the player has scored in the stage |
| The total number of penalty goals the player has scored in the stage |
| The type of the standings. Possible values are: goals, cards or assists |
Endpoint details
Authorization
API Key
Pagination
NO
Allowed nested includes
0
Available parameters
range
A range of 2 dates separated by a comma. format should be YYYY-MM-DD.
Endpoint details
Authorization
API Key
Pagination
NO
Allowed nested includes
2
Available parameters
include
Enrich the API with more data and/or nested includes. Can be used by adding &include=
to your request url.
Endpoint details
Authorization
API Key
Pagination
NO
Allowed nested includes
2
Available parameters
include
Enrich the API with more data and/or nested includes. Can be used by adding &include=
to your request url.
Field
Description
player_id
The unique id of the main player
team_id
The unique id of the team the player belongs to
country_id
The unique id of the country the player is from
position_id
The unique id of the position the player plays in
common_name
The common name the player is known for
display_name
The display name of the player. Often used to show in the lineup formation
fullname
The full name of the player
firstname
The first name of the player
lastname
The last name of the player
nationality
The nationality of the player
birthdate
The date of birth of the player
birthcountry
The country the player was born in
birthplace
The place the player was born in
height
The height of the player
weight
The weight of the player
image_path
The URL of the player image
Endpoint details
Authorization
API Key
Pagination
NO
Allowed nested includes
0
Endpoint details
Authorization
API Key
Pagination
NO
Allowed nested includes
2
Available parameters
include
Enrich the API with more data and/or nested includes. Can be used by adding &include=
etc to your request url.
Endpoint details |
Authorization | API Key |
Pagination | NO |
Allowed nested includes | 3 |
Available parameters |
include | Enrich the API with more data and/or nested includes. Can be used by adding |
Endpoint details |
Authorization | API Key |
Pagination | NO |
Allowed nested includes | 3 |
Available parameters |
include | Enrich the API with more data and/or nested includes. Can be used by adding |
Endpoint details |
Authorization | API Key |
Pagination | NO |
Allowed nested includes | 3 |
Available parameters |
include | Enrich the API with more data and/or nested includes. Can be used by adding |
Endpoint details |
Authorization | API Key |
Pagination | NO |
Allowed nested includes | 0 |
GET
Rounds by Season IDfixtures
results
season
league
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:
Odds are used to add betting functionality to your application. This endpoint can be used for Pre-match Odds, we do have an endpoint for In-Play Odds (live) as well.
We offer the ability to request Odds by Fixture, by Fixture And Bookmaker or by Fixture And Market. Another option to get information about Odds is to use the proper Include on any Fixtures related endpoint. Using the Include odds
or flatodds
will enrich the response of a Fixture with all Odds we have available.
GET
Rounds by IDfixtures
results
season
league
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:
The Bookmakers endpoint will help you to set up Odds in a proper way in your website/application. This endpoint is very useful for administrative purposes to check and structure the Bookmakers' availability.
Bookmakers' data can be requested by ID or all in one response.
Check this endpoint in Postman.
Markets represent the betting options available per Bookmaker.
The Markets endpoint will help you to set up the Odds properly at your website/application. This endpoint is very useful for administrative purposes to check and structure the Markets availability.
Markets data can be requested by ID or all in one response.
Check this endpoint in Postman.
GET
Stage by IDfixtures
results
season
league
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:
Check this endpoint in Postman.
GET
Stage by IDfixtures
results
season
league
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:
Check this endpoint in Postman.
Field
Description
id
The unique id of the round
name
The name of the round
league_id
The unique league id the round belongs to
season_id
The unique season id the round belongs to
stage_id
The unique stage id the round belongs to
start
The start date of the round
end
The end date of the round
Endpoint details
Authorization
API Key
Pagination
NO
Allowed nested includes
2
Available parameters
include
Enrich the API with more data and/or nested includes. Can be used by adding &include=
to your request url.
Field
Description
id
The unique id of the round
name
The name of the round
league_id
The unique league id the round belongs to
season_id
The unique season id the round belongs to
stage_id
The unique stage id the round belongs to
start
The start date of the round
end
The end date of the round
Field | Description |
| The unique id of the stage |
| The name of the stage |
| Indicates what kind of type the stage is |
| The unique league id the stage belongs to |
| The unique season id the stage belongs to |
| The order of the stages |
| Indicates if the stage supports standing |
Endpoint details
Authorization
API Key
Pagination
NO
Allowed nested includes
2
Available parameters
include
Enrich the API with more data and/or nested includes. Can be used by adding &include=
to your request url.
Endpoint details
Authorization
API Key
Pagination
NO
Allowed nested includes
0
Endpoint details
Authorization
API Key
Pagination
NO
Allowed nested includes
0
Endpoint details
Authorization
API Key
Pagination
NO
Allowed nested includes
0
Endpoint details
Authorization
API Key
Pagination
NO
Allowed nested includes
0
Endpoint details
Authorization
API Key
Pagination
NO
Allowed nested includes
0
Endpoint details
Authorization
API Key
Pagination
NO
Allowed nested includes
0
Endpoint details |
Authorization | API Key |
Pagination | NO |
Allowed nested includes | 0 |
Endpoint details |
Authorization | API Key |
Pagination | NO |
Allowed nested includes | 2 |
Available parameters |
include | Enrich the API with more data and/or nested includes. Can be used by adding |
Field | Description |
| The unique id of the stage |
| The name of the stage |
| Indicates what kind of type the stage is |
| The unique league id the stage belongs to |
| The unique season id the stage belongs to |
| The order of the stages |
| Indicates if the stage supports standings |
Endpoint details |
Authorization | API Key |
Pagination | NO |
Allowed nested includes | 0 |
Endpoint details |
Authorization | API Key |
Pagination | NO |
Allowed nested includes | 2 |
Available parameters |
include | Enrich the API with more data and/or nested includes. Can be used by adding |
Endpoint details |
Authorization | API Key |
Pagination | NO |
Allowed nested includes | 0 |
Endpoint details |
Authorization | API Key |
Pagination | NO |
Allowed nested includes | 0 |
GET
Probabilities by Fixture IDfixture
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:
One of our newest features is the Prediction API. Predictions on markets like the Winner, Correct Scores, Over/Under and Both Teams To Score (BTTS) are all available here, produced with our Machine Learning techniques and models.
We offer endpoints to get the Probabilities per fixture or to Get all Probabilities. All probabilities are available 21 days before the match starts.
Sportmonks also detects Value Bets for you. The Value Bet API is processing thousands of historical odds data and market trends to find Value opportunities, compared to bookmakers' odds. Please note that not every match has Value Bets. Available endpoints are Value Bet by Fixture and Get all Value Bets.
By using this endpoint, you can get all predictions on markets like, Winner, Correct Score, Over/Under, BTTS and more. The Probabilities values are between 0 and 100, representing the success probability percentage of the given market. Probabilties are available 21 days before a game starts.
You can get all probabilities for all matches via this endpoint. It is also possible to get the Probabilitiy By Fixture Id. This will provide you the probabilities for an individual fixture. Relationship includes like &include=fixture.localTeam,fixture.visitorTeam
are often used here.
Another option that is highly popular is adding the relationship include&include=probability
to your requests from the Fixture endpoint or Livescore endpoint. You can find more info in the relationship section about fixture probabilities.
GET
ProbabilitiesNo parameters available for this endpoint.
No includes available for this endpoint.
GET
Team Squad by Team and Season IDplayer
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:
Besides the Prediction API, we also have the Value Bet API. While the Prediction API evaluates the probabilities of game events, the Value Bet API is processing thousands of historical odds data and market trends to find Value opportunities, compared to bookmakers' odds.
Once the opening odds are available, the value detection algorithm is running every 10 minutes up to the beginning of the match. Each value detected by the model is coming with a set of features described below.
Please note that our algorithm detects Value Bets based on all available odds in combination with the fair_odd
calculated by the Value Bet algorithm. Therefore, not every match has a Value Bet available.
It is possible to use the Value Bet API endpoint as described on this page. It will give you all Value Bets detected. It is also possible to use the Value Bet By Fixture Id.
If you want to combine your Value Bets requests with your requests on the Fixture endpoint or Livescore endpoint, you can add the relationship include&include=valuebet.
See the Relationship Fixture Value Bet for more info.
Get
Value Betsfixture
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:
Besides the Prediction API, we also have the Value Bet API. While the Prediction API evaluates the probabilities of game events, the Value Bet API is processing thousands of historical odds data and market trends to find Value opportunities, compared to bookmakers' odds.
Once the opening odds are available, the value detection algorithm is running every 10 minutes up to the beginning of the match. Each value detected by the model is coming with a set of features described below.
Please note that our algorithm detects Value Bets based on all available odds in combination with thefair_odd
calculated by the Value Bet algorithm. Therefore, not every match has a Value Bet available.
It is possible to use the Value Bet API endpoint as described on this page. It will give you all Value Bets detected. It is also possible to use the Value Bet By Fixture Id.
If you want to combine your Value Bets requests with your requests on the Fixture endpoint or Livescore endpoint, you can add the relationship include &include=valuebet.
See the Relationship Fixture Value Bet for more info.
Get
Value Bet by Fixture IDfixture
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:
Welcome to Sportmonks’ Football API. We have designed the API for iGaming, media, developers and football enthusiasts. Sportmonks ensures that you can create a football application that meets your wishes and needs.
Football API 2.0 is a REST API that can be used to request football data from our wide-ranging database and has the following characteristics:
Highly customizable requests
Incredibly fast livescores
Reliable and accurate data
You will find valuable tutorials and how-to guides to help you kickstart your application on these documentation pages. Let's get started right away by making your first request!
Endpoint details
Authorization
API Key
Pagination
NO
Allowed nested includes
0
Available parameters
include
Enrich the API with more data and/or nested includes. Can be used by adding &include=
etc to your request url.
Endpoint details
Authorization
API Key
Pagination
NO
Allowed nested includes
0
Available parameters
include
Enrich the API with more data and/or nested includes. Can be used by adding &include=
etc to your request url.
Endpoint details
Authorization
API Key
Pagination
NO
Allowed nested includes
0
Endpoint details
Authorization
API Key
Pagination
NO
Allowed nested includes
0
Endpoint details
Authorization
API Key
Pagination
NO
Allowed nested includes
0
Endpoint details
Authorization
API Key
Pagination
NO
Allowed nested includes
0
Available parameters
include
Enrich the API with more data and/or nested includes. Can be used by adding &include=
etc to your request url.
Endpoint details
Authorization
API Key
Pagination
NO
Allowed nested includes
0
Endpoint details
Authorization
API Key
Pagination
NO
Allowed nested includes
0
Endpoint details
Authorization
API Key
Pagination
NO
Allowed nested includes
3
Available parameters
include
Enrich the API with more data and/or nested includes. Can be used by adding &include=
etc to your request url.
Video Highlights are links to videos posted on social media networks. It can contain videos of Goals, Cards or other Events. Sometimes a video compilation of events is provided.
Video Highlights is a community feature, which basically means we have no control over the availability of videos. So, we cannot guarantee the video you are looking for is available.
Highlights are often used as an Include for the Fixture endpoint, but you can use Fixture
as an Include for the Highlight endpoint.
In case a team got points corrections they can be found here. It will return an array of correction objects per stage. In some occasions a stage proceeds with standings from an earlier stage.
Leagues can be split up into Rounds representing a week a game is played in. With this endpoint we give you the ability to request data for a single Round as well as all Rounds of a Season.
The endpoint is often used in combination with includes like Results
or Fixtures
to show them based on Rounds.
Check this endpoint in Postman.
Endpoint details
Authorization
API Key
Pagination
NO
Allowed nested includes
0