Here you will find everything you need to know about Sportmonks’ Football API 2.0 (Deprecated).
Quick starts
Features of our APIs
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.
Continents
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.
Changelog
20.0.55 - 2022-01-14
Change
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}
2.0.54 - 2021-08-02
Added
Added the opportunity to retrieve all bookmakers by Fixture ID.
2.0.54 - 2021-07-05
Added
Added 'is_friendly' property on league related responses or includes. This indicates if the league is friendly.
2.0.53 - 2021-06-23
Added
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.
2.0.52 - 2021-06-06
Added
Added the opportunity to retrieve all fixtures by Market ID. This allows you to gather all fixtures that have a specific odd market available.
2.0.51 - 2021-05-06
Added
Added the News API (BETA) for the English Premier League and European Championship.
2.0.51 - 2021-04-06
Added
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.
GET All Continents
GET All Continents
https://soccer.sportmonks.com/api/v2.0/continents
Endpoint details
Authorization
API Key
Pagination
YES
Allowed nested includes
3
Parameters
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.
Include options
countries
Includes are the cornerstone of our API and allow you to enrich and customize your requests. This flexibility is what distinguishes Sportmonks from our competitors.
You can learn more about what includes are and how they work here:
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.
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.
Added new weather types. You can check an overview of all possible outcomes on our page.
Added 20 new leagues, including the UEFA Conference League (ID: 2286). You can check all leagues on our .
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.
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.
Include options
countryseasonseasons
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:
Enrich the API with more data and/or nested includes. Can be used by adding &include= etc. to your request url.
Include options
countryseasonseasons
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 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.
Include options
leaguescontinentcovid
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 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.
Documentation for the documentation
So, yes. This is indeed a documentation page about our documentation! Our documentation sections are classified based on our users' capabilities.
This way, you'll know where and how to navigate through our massive documentation. Good luck!
Want to know more about who we are?
Leagues
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.
Get Started
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.
Overview
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
What is Football API 2.0?
Highly customizable requests
Incredibly fast livescores
Reliable and accurate data
Authentication
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:
Code number
Description
200
Successful request and data was returned
400
Part of the request is malformed; the exact reason can be found in the response
401
Request is not authenticated
403
Unauthorized request to access data from an ineligible plan
429
You have reached the response rate limit of your plan
500
Internal error with our servers
Your first request
Now that all prerequisites have been fulfilled, we’re ready to send our first request to the API!
Build the request
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
https://soccer.sportmonks.com/api/v2.0/
An example of a correctly authenticated request would be:
Indicates if the league is active or not. Possible values are 'true' or 'false'
type
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
What can you do with the data?
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.
Code libraries
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:
Different plans and data features
Indicates what kind of league this is. Possible values: 'domestic', 'cup', 'international'. More values can be found
Check this endpoint in Postman.
Check this endpoint in Postman.
Check this endpoint in Postman.
Welcome to the documentation page about Sportmonks’ documentation! Now that you have completed our, you can freely choose what you want to go through next! Our extensive API documentation consists of the following sections:
The, 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 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 , or.
Finally, the API References, are the most common resources used by developers already familiar with APIs. We also provide our API references in .
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 .
Check this endpoint in Postman.
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:
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.
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).
Indicates what kind of league this is. Possible values: 'domestic', 'cup', 'international'. More values can be found
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.
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.
Fixtures
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.
GET All Seasons
GET All Seasons
https://soccer.sportmonks.com/api/v2.0/seasons
Endpoint details
Authorization
API Key
Pagination
YES
Allowed nested includes
4
Parameters
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.
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:
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:
Enrich the API with more data and/or nested includes. Can be used by adding &include= etc. to your request url.
Include options
countryseasonseasons
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:
Indicates if the league is active or not. Possible values are 'true' or 'false'
type
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
Search Leagues by Name
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.
Search League by Name
Parameters
Include options
countryseasonseasons
Includes are the cornerstone of our API and allow you to enrich and customize your requests. This flexibility is what distinguishes us from our competitors.
You can learn more about what includes are and how they work here:
Example response
GET All Countries
GET All Countries
Parameters
Include options
leaguescontinentcovid
Includes are the cornerstone of our API and allow you to enrich and customize your requests. This flexibility is what distinguishes us from our competitors.
You can learn more about what includes are and how they work here:
Example response
Statistics
Statistics tutorial
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.
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:
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:
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:
Includes are the cornerstone of our API and allow you to enrich and customize your requests. This flexibility is what distinguishes us from our competitors.
You can learn more about what includes are and how they work here:
Example response
Check this endpoint in Postman.
Check this endpoint in Postman.
Check this endpoint in Postman.
Filter fixtures based on a comma separated list of status codes as defined in the Can be used by adding &status= etc to your request url.
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.
Indicates what kind of league this is. Possible values: 'domestic', 'cup', 'international'. More values can be found
Check this endpoint in Postman.
Check this endpoint in Postman.
Check this endpoint in Postman.
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 .
Indicates if the league is active or not. Possible values are 'true' or 'false'
type
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
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
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
commentaries
Indicates if this fixture has commentaries available
attendance
Give information about the visitor attendance of the fixture
pitch
details
Optional additional information.
neutral_venue
Indicates if the fixture was played at a neutral fixture. This often happens in cup finals
formations
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
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
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.
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
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
commentaries
Indicates if this fixture has commentaries available
attendance
Give information about the visitor attendance of the fixture
pitch
details
Optional additional information.
neutral_venue
Indicates if the fixture was played at a neutral fixture. This often happens in cup finals
formations
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
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
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
commentaries
Indicates if this fixture has commentaries available
attendance
Give information about the visitor attendance of the fixture
pitch
details
Optional additional information.
neutral_venue
Indicates if the fixture was played at a neutral fixture. This often happens in cup finals
formations
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
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
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.
News API
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.
"news": {
"data": [
{
"fixture_id": 17922163,
"introduction": "After a month, UEFA Euro 2020 – a unique format involving 11 different host countries comes to an end at Wembley with Italy vs. England taking the center stage in the final scheduled for kick-off at 20:00 (GMT+1) on Sunday, the 11th of July.",
"localteam": "Italy assured their place in the final on Tuesday after defeating Spain in a penalty shootout at Wembley. Both sides had remained locked in a 1-1 draw after 120 minutes. A curling shot into the far-left corner from Federico Chiesa (60') flew past Unai Simon to hand Gli Azzurri the lead right on the hour mark. But an equally fantastic goal from second-half substitute, Alvaro Morata (80') had Donnarumma diving the wrong way as Spain levelled the scoreline. Moments later, Berardi saw his goal ruled off by the flag before the game went on to penalties. Unai Simon kept Locatelli's penalty out but Spain failed to take the advantage as Mikel Oyarzabal fired well above the cross-bar. Minutes later, Donnarumma kept Alvaro Morata's poor effort out before a Jorginho-styled penalty from the Chelsea midfielder sent Italy into the final. The Blues are on the verge of picking up their second European Championship after 53 years, - their first being in 1968 under the late coach, Ferruccio Valcareggi. Roberto Mancini will be looking to pen his name in the annals of history as the first coach to hand Italy the European title in this modern football era. - With a side unbeaten in six games across all competitions: WWWWWD. Federico Chiesa's performance against Belgium saw him keep his place in the starting line-up for the game against Spain. He is expected to keep Berardi on the bench once again while playing alongside Insigne and Lazio's Immobile in Mancini's attacking 4—3—3 formation. Manuel Locatelli, currently on Juve's radar with a €40 million bid on the horizon is expected to start from the bench once again on Sunday with Jorginho and Verratti being preferred choices in the midfield. On availability, Roma's Leonardo Spinazzola went under the knife days ago after picking up an Achilles tendon rupture and will not be available for this fixture. Last Sunday, Roma's new head coach, Jose Mourinho confirmed that the 28-year-old will be out for a few months.",
"visitorteam": "The Three Lions put up another convincing performance on home soil at Wembley on Wednesday, defeating Denmark 2-1 after extra time to seal a place in the final. The Danish Dynamite picked up the lead after a stunning free-kick from Mikkel Damsgaard (30') at the half-hour mark found its way over the wall and into the back of the net. But an own goal from the Danish captain, AC Milan's Simon Kjaer (39' O.G.) gave England a huge helping hand. However, a dubious penalty which was awarded while another ball was on the pitch saw Harry Kane (104') tuck in the rebound after an initial save by Danish goalkeeper, Kasper Schmeichel. It was his 4th goal of the tournament, one which propelled England into their first-ever European Championship final. On Sunday, Gareth Southgate's 4—2—3—1 formation will see the English captain leading the attack once again. Harry Kane is a goal shy of joining Cristiano Ronaldo and Patrik Schick as joint top-scorers of Euro 2020. Gareth Southgate has kept everyone happy despite the stiff competition for a starting spot in the star-studded squad. And barring any late injuries, we could see the same personnel from the game against Denmark start against Italy when England returns unbeaten in six games across all competitions: WDWWWW. This final comes after 50 games, 140 goals and a total attendance of 1,032,105 fans at the stadiums.",
"type": "preview",
"created_at": "2021-07-09 07:33:34",
"updated_at": "2021-07-09 07:33:34"
Livescores
Via the Livescore endpoint, you can obtain live data of Games of the current day and live data for In-Play Games. The Livescore endpoint provides real-time data about Game information and Events like Goals, Cards, Substitutions, Line-ups, In-Play Statistics etc.
For many customers, Livescores is the main endpoint for their app/website. Be aware your access is limited to games of the Leagues that are available in the plan you are subscribed to.
Responses of the Livescore endpoint are highly customizable because there are many Includes available to extend the response. There are always two teams involved in a Livescore Game. Requests often start with the Includes localTeam and visitorTeam. Events, Stats, Lineups, Comments, Trends etc. are often added to extend the response.
This endpoint is sorted by id descending. By adding a from_id to the API request, you will only receive deleted fixtures with a higher id than the one given.
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 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
commentaries
Indicates if this fixture has commentaries available
attendance
Give information about the visitor attendance of the fixture
pitch
details
Optional additional information.
neutral_venue
Indicates if the fixture was played at a neutral fixture. This often happens in cup finals
formations
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
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
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.
GET Last Updated Fixtures
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,
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:
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:
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 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
commentaries
Indicates if this fixture has commentaries available
attendance
Give information about the visitor attendance of the fixture
pitch
details
Optional additional information.
neutral_venue
Indicates if the fixture was played at a neutral fixture. This often happens in cup finals
formations
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
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
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.
Video Highlights
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.
We 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.
Parameters
Include options
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:
Example response
Please note that you can also use the news include on our fixtures and livescores endpoints.
Commentaries
The Commentary endpoint can be used to request the Textual representation of actions taken place in the Game. Commentaries are marked as Important or Goal when they meet that criteria.
GET All News
GET News of all fixtures
We 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.
Parameters
Include options
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:
Example response
GET News by Season ID
GET News of all fixtures
We 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.
Parameters
Include options
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.
Example response
Commentaries by Fixture ID
Get Commentaries by Fixture ID
Parameters
No parameters available for this endpoint.
Include options
No includes available for this endpoint.
Example response
Head 2 Head
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 LIVE Standings
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
Includes are the cornerstone of our API and allow you to enrich and customize your requests. This flexibility is what distinguishes us from our competitors.
You can learn more about what includes are and how they work here:
Example Response
Standings
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.
GET Standings by Season ID and Round ID
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.
GET Standings by Season ID and Round ID
Parameters
No parameters available for this endpoint.
Include options
No includes available for this endpoint.
Example response
GET Standings by Season ID
GET Standings by Season ID
Parameters
Include options
Note that includes on this endpoint must be prefixed by "standings."
teamleagueseasonroundstages
Includes are the cornerstone of our API and allow you to enrich and customize your requests. This flexibility is what distinguishes us from our competitors.
You can learn more about what includes are and how they work here:
Example response
Season Field Description
Standings Field Description
Indicates what kind of league this is. Possible values: 'domestic', 'cup', 'international'. More values can be found
Filter fixtures based on a comma separated list of status codes as defined in the Can be used by adding &status= etc to your request url.
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:
Filter fixtures based on a comma separated list of status codes as defined in the Can be used by adding &status= etc to your request url.
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:
In the the fixtures will be available 15 minutes before the match has started and 15 mins after it has ended.
Check this endpoint in Postman.
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
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
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
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
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:
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.
Check this endpoint in Postman.
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.
Filter fixtures based on a comma separated list of status codes as defined in the Can be used by adding &status= etc to your request url.
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.
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.
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:
"data": [
{
"fixture_id": 17922163,
"introduction": "After a month, UEFA Euro 2020 – a unique format involving 11 different host countries comes to an end at Wembley with Italy vs. England taking the center stage in the final scheduled for kick-off at 20:00 (GMT+1) on Sunday, the 11th of July.",
"localteam": "Italy assured their place in the final on Tuesday after defeating Spain in a penalty shootout at Wembley. Both sides had remained locked in a 1-1 draw after 120 minutes. A curling shot into the far-left corner from Federico Chiesa (60') flew past Unai Simon to hand Gli Azzurri the lead right on the hour mark. But an equally fantastic goal from second-half substitute, Alvaro Morata (80') had Donnarumma diving the wrong way as Spain levelled the scoreline. Moments later, Berardi saw his goal ruled off by the flag before the game went on to penalties. Unai Simon kept Locatelli's penalty out but Spain failed to take the advantage as Mikel Oyarzabal fired well above the cross-bar. Minutes later, Donnarumma kept Alvaro Morata's poor effort out before a Jorginho-styled penalty from the Chelsea midfielder sent Italy into the final. The Blues are on the verge of picking up their second European Championship after 53 years, - their first being in 1968 under the late coach, Ferruccio Valcareggi. Roberto Mancini will be looking to pen his name in the annals of history as the first coach to hand Italy the European title in this modern football era. - With a side unbeaten in six games across all competitions: WWWWWD. Federico Chiesa's performance against Belgium saw him keep his place in the starting line-up for the game against Spain. He is expected to keep Berardi on the bench once again while playing alongside Insigne and Lazio's Immobile in Mancini's attacking 4—3—3 formation. Manuel Locatelli, currently on Juve's radar with a €40 million bid on the horizon is expected to start from the bench once again on Sunday with Jorginho and Verratti being preferred choices in the midfield. On availability, Roma's Leonardo Spinazzola went under the knife days ago after picking up an Achilles tendon rupture and will not be available for this fixture. Last Sunday, Roma's new head coach, Jose Mourinho confirmed that the 28-year-old will be out for a few months.",
"visitorteam": "The Three Lions put up another convincing performance on home soil at Wembley on Wednesday, defeating Denmark 2-1 after extra time to seal a place in the final. The Danish Dynamite picked up the lead after a stunning free-kick from Mikkel Damsgaard (30') at the half-hour mark found its way over the wall and into the back of the net. But an own goal from the Danish captain, AC Milan's Simon Kjaer (39' O.G.) gave England a huge helping hand. However, a dubious penalty which was awarded while another ball was on the pitch saw Harry Kane (104') tuck in the rebound after an initial save by Danish goalkeeper, Kasper Schmeichel. It was his 4th goal of the tournament, one which propelled England into their first-ever European Championship final. On Sunday, Gareth Southgate's 4—2—3—1 formation will see the English captain leading the attack once again. Harry Kane is a goal shy of joining Cristiano Ronaldo and Patrik Schick as joint top-scorers of Euro 2020. Gareth Southgate has kept everyone happy despite the stiff competition for a starting spot in the star-studded squad. And barring any late injuries, we could see the same personnel from the game against Denmark start against Italy when England returns unbeaten in six games across all competitions: WDWWWW. This final comes after 50 games, 140 goals and a total attendance of 1,032,105 fans at the stadiums.",
"type": "preview",
"created_at": "2021-07-09 07:33:34",
"updated_at": "2021-07-09 07:33:34"
},
{
"fixture_id": 17922165,
"introduction": "UEFA Euro 2020 – Semi-final fixture, England vs. Denmark kicks off at 20:00 (GMT+1) on Wednesday, the 7th of July at Wembley Stadium.",
"localteam": "The Three Lions breezed past Ukraine in Saturday's quarter-final fixture played at the Stadio Olimpico in Rome. Dominant, they pinned the Ukrainians on their own half for the most part of the game. Harry Kane (4') helped England to the lead inside the opening minutes after getting on the end of a defense splitting pass from Raheem Sterling for the only goal of the first-half. A minute into the second-half, England doubled the lead after Luke Shaw picked out Harry Maguire (46') from the crowd with an inch-perfect cross. Four minutes later, Harry Kane (50') completed the brace, – once again with Luke Shaw providing the assist. The English captain would have completed the hattrick but was denied by a remarkable save from the Ukrainian goalkeeper, Geroge Buschan. Moments later, Jordan Henderson (63') put the game to bed midway through the second-half with England's fourth, his first-ever goal for the Three Lions. Yet to concede a goal at Euro 2020, England returns unbeaten in six games across all international competitions: WWDWWW. The Three Lions are also unbeaten since the turn of the year. The last time they tasted defeat was on the 15th of November 2020 when they lost to Belgium, 0-2. On Wednesday, Gareth Southgate's 4—2—3—1 formation will see Harry Kane leading the attack once again while Dominic Calvert-Lewin is expected to make an off-the-bench appearance. Jack Grealish was an unused sub in the game against Ukraine. However, he is expected to make an appearance before the game comes to a close on Wednesday when England returns to face the Danish Dynamite.",
"visitorteam": "Denmark defeated Czech Republic, 2-1 at Baku Stadium when both sides met on Saturday the 3rd of July. Thomas Delaney (5') put the Danes ahead in the opening minutes with a fine header off a corner kick from Jens Stryger Larsen. After several clear-cut chances went by on both ends, the Danes eventually doubled their lead through Kasper Dolberg (42') who tapped in a cross from Joakim Maehle to leave the stunned Czech goalkeeper, Tomas Vaclik watching as the net rattled. But Czech's Patrik Schick (49') would halve the deficit and draw level with Cristiano Ronaldo as joint top-scorer after bagging his fifth goal of the tournament. The 2-1 win leaves Denmark with three straight victories in six games across all competitions: WLLWWW. Coach Kasper Hjulmand's 3—4—2—1 formation or its variant, 3—4—3 will see Yussuf Poulsen return to the starting line-up. Meanwhile, Dolberg is expected to start off the bench with the return of the RB Leipzig forward. Danish captain, AC Milan's Simon Kjaer has been instrumental in the latest string of positive results for the Danish Dynamite. He will return to put in another solid performance at the heart of the three-man Danish wall on Wednesday. Expected at his right is Chelsea's Andreas Christensen, and on his left, Southampton's Jannik Vestergaard. The winner of this fixture will face either Spain or Italy in the final at Wembley on Sunday, the 11th of July.",
"type": "preview",
"created_at": "2021-07-05 10:13:24",
"updated_at": "2021-07-05 10:13:24"
},
{
"fixture_id": 17922164,
"introduction": "UEFA Euro 2020 – Semi-final fixture, Italy vs. Spain kicks off at 20:00 (GMT+1) on Tuesday, the 6th of July at Wembley Stadium.",
"localteam": "Italy defeated Belgium on Friday, the 2nd of July at Allianz Arena, Munich, to set up this semi-final fixture against La Roja. Kevin De Bruyne had tested Donnarumma earlier with a vicious shot before Romelu Lukaku forced a save out of the 22-year-old Italian goalkeeper who remains without a club after his contract with AC Milan ran out on the 30th of June. Minutes later, a venomous shot from Nicolo Barella (31') handed the Italians the lead. The Azzurri struck again – extending their lead with a stunning 20-yard curling shot from Lorenzo Insigne (44'). A minute later, they saw their two-goal lead cut down to one after giving away a penalty. Romelu Lukaku (45' P) wasted no time in sending the outstanding Italian goalkeeper the wrong way, - halving the deficit at the stroke of half-time. However, both sides – most notably, Belgium, failed to convert any despite having several clear-cut chances. The 2-1 win saw Italy extend their unbeaten record run to 32 games across all competitions and leaves them with a sextuple of victories: WWWWWW. Known for the 4—3—3 formation, Roberto Mancini will likely return with the same shape on Tuesday. Berardi is expected to find his way back into the starting line-up after being dropped to the bench against the Red Devils. Meanwhile, Leonardo Spinazzola who tried to outrun his legs in the game against Belgium will miss this fixture and will be sidelined for months after rupturing an Achilles tendon. Manuel Locatelli, the subject of a €35M bid from Arsenal was an unused sub against Belgium. He is expected to start from the bench once again on Tuesday.",
"visitorteam": "Spain were held to a 1-1 draw against Switzerland at the end of 120 minutes before the game went on into a penalty shootout. An own goal from Denis Zakaria (8' O.G.) minutes after kick-off had given Spain an early lead. But Xherdan Shaqiri (68') levelled the score-line minutes after the break. Nine minutes after the Swiss goal, Spain picked up the numerical advantage after Remo Freuler (77' R.) saw a straight red for a reckless two-footed challenge. However, the Swiss held firm – keeping the door closed until the end of extra time despite being the side with a man down. But a string of poor penalties - albeit from both sides, eventually saw Spain besting the Swiss in the shootout. On Tuesday, an attacking 4—3—3 formation which has become prominent over the length of the tournament will likely be seen again from Luis Enrique. In attack, we can expect Alvaro Morata to be flanked on the right by Ferran Torres and on the left by Pablo Sarabia. However, the PSG winger, Sarabia remains doubtful due to an abductor problem. He is expected to undergo further tests before the game on Tuesday. The Red Fury remains unbeaten in six games across all competitions: DDDWWD*.",
"type": "preview",
"created_at": "2021-07-04 16:08:47",
"updated_at": "2021-07-04 16:08:47"
},
"data": [
{
"fixture_id": 16943186,
"introduction": "Wolverhampton Wanderers vs. Manchester United kicks off at 16:00 (GMT+1) on Sunday, May 23 at the Molineux Stadium.",
"localteam": "Wolverhampton Wanderers lost to Everton on Wednesday the 19th of May at Goodison Park where they made their penultimate appearance of the season. With only one shot on target in the final 42 minutes, Wolves failed to find an equalizer to Richarlison’s goal (48’). The Brazilian had got on the end of Gylfi Sigurdsson’s cross minutes after the interval. Nuno’s men will be finishing outside the top-ten this season. After three defeats in five games: LDWLL (Premier League), Wolves remain in 12th place with 45 points from 12W, 9D & 16L. Over the last two seasons: 2018/19 & 2019/20, Wolves have finished inside the top-ten, 7th place on both occasions. However, they have failed to replicate last season’s form partly due to the loss of key personnel – most importantly, Raul Jimenez while the likes of Pedro Neto, Traore, and Daniel Podence have hit a rough patch of form. With 10 goals in total between the trio and a team goal ratio of only 0.95 goals per game, Wolves have struggled to pose any real threat to the opposition. Nuno Espirito Santo chose a 3—4—1—2 formation against Everton and will likely do so once again on Sunday. Rui Patricio was an unused substitute against the Toffees but could return to the starting lineup on Sunday.",
"visitorteam": "Manchester United were denied a win by relegated Fulham in their last home game of the season. The Red Devils were held to a 1-1 draw after Fulham’s Joe Bryan (76’) equalized with just over a quarter of an hour left to play. Bruno Fernandes' flick split Fulham’s defense and enabled Edinson Cavani (15’) to break away and chip the ball over goalkeeper Alphonse Areola from 40 yards. – A remarkable goal and contender for goal of the season from the man-of-the-match. The Uruguayan recently had his contract extended for a year (until June 22) after a stellar performance with the Red Devils. United are 2nd with 71 points after 20W, 11D & 6L. A goal ratio of 1.92 goals per game has seen them score 71 goals – the second highest in the league, behind Manchester City (78). With only one win in five games for the Red Devils: DWLLD (Premier League), they appear not to be in the best form ahead of the Europa League final against Villarreal on May 26. A 4—2—3—1 formation with Cavani in attack is expected to face Wolves on Sunday. Phil Jones and Anthony Martial are ruled out of this tie while Harry Maguire's availability remains in doubt.",
"type": "preview",
"created_at": "2021-05-21 14:12:15",
"updated_at": "2021-05-21 14:12:15"
},
{
"fixture_id": 16943185,
"introduction": "West Ham United vs. Southampton F.C. kicks off at 16:00 (GMT+1) on Sunday, May 23 at the London Stadium.",
"localteam": "West Ham defeated West Bromwich Albion, 3-1 in their penultimate fixture of the season on Wednesday, the 19th of May away from home. A goal from Tomas Soucek (45’) at the stroke of half-time coupled with goals from Angelo Obinze Ogbonna (82’) and Michail Antonio (88’) saw the Hammers outscore West Bromwich Albion whose only goal was scored by the Brazilian, Matheus Pareira (27’). The win leaves West Ham with a form that reads: LWLDW (Premier League) and in 6th place. Over the course of the season, West Ham have scored 59 goals (1.59 gpg) and conceded 47 - hence, they have a goal difference of +12 coupled with 62 points after 18W, 8D & 11L. David Moyes was hoping to play the UEFA Champions League with West Ham next season but it appears he would have to settle for the Europa League. On Sunday he would be looking for his 19th victory of the season with the Lions. His preferred 4—2—3—1 formation would be seen again on Sunday when he takes on Southampton. Michail Antonio who has 10 goals this season will likely be leading the attack once again. West Ham have no major injury worries ahead of this tie.",
"visitorteam": "Southampton remain in 14th place after 12W, 7D & 18L. On Tuesday, the 18th of May, they lost to Leeds United, 2-0 on home soil. The first half came to an end without any goal but Leeds’ top scorer, Patrick Bamford broke the deadlock in the 73rd minute for what would be his 16th goal of the season. The game would have finished at 1-0 but in the final moments, Tyler Roberts (90’+ET) found the back of the net for Leeds’ second goal – the final goal of the game. 2-0! It finished as the second defeat for Southampton in five games: DLWWL (Premier League). The Saints have scored 47 goals (1.27 gpg) over the course of the season and conceded 65. - Hence, have a G.D. of -18. Ralph Hasenhüttl’s Southampton could finish in 12th place if they win this tie and the other results go their way. However, they will be looking for at least a draw. A 4—4—2 formation with Danny Ings and Tella in attack is expected from Ralph Hasenhüttl when Southampton with 43 points make their final Premier League appearance of the season. William Smallbone, Oriol Romeu, and Ryan Bertrand are all ruled out of this tie. Martin Atkinson will officiate this tie while Craig Pawson will be the VAR. Peter Kirkup will be the assistant VAR for the game.",
"type": "preview",
"created_at": "2021-05-21 14:11:22",
"updated_at": "2021-05-21 14:11:22"
},
{
"fixture_id": 16943184,
"introduction": "Sheffield United vs. Burnley F.C. kicks off at 16:00 (GMT+1) on Sunday, May 23 at Bramall Lane.",
"localteam": "Relegated Sheffield United lost to Newcastle United on Wednesday the 19th of May when they visited Saint James’ Park. The game ended 1-0 but the score-line wasn’t a true reflection of the events in the game. Sheffield’s McGoldrick had a clear-cut chance to put the Blades ahead but pulled his shot wide – missing Newcastle’s goal by inches. Newcastle had their chance at the other end twenty minutes later, but goalkeeper Aaron Ramsdale was called into action and produced a fantastic save to deny Jonjo Shelvey a goal. The Magpies eventually broke the deadlock after a fantastic header saw Joseph Willock (45’+ET) score his 6th successive goal in the Premier League. Aged 21, he became the youngest player to do so. 1-0! It finished as Sheffield United picked up their third defeat in five games: WLLWL (Premier League). The Blades would be joining Fulham and West Bromwich Albion in the Championship next season. They will remain in 20th place regardless of the result from this fixture. The Blades have scored only 19 goals (0.51 gpg) this season but conceded as many as 63. They have 20 points after 6W, 2D & 29L. Paul Heckingbottom will likely adopt a conventional 4—4—2 formation on Sunday in the final game of the season. The striking partnership between McGoldrick and Jebbison will likely be seen again. On availability, Jack O’Connell, Billy Sharp, Oliver Burke, and Oliver McBurnie are all ruled out while Ethan Ampadu remains doubtful.",
"visitorteam": "Burnley are 11 points above the bottom three in 17th place with 39 points after 10W, 9D & 18L. On Wednesday, they succumbed to another defeat, 3-0 in the hands of Liverpool. The Reds moved to 4th place on the league table after the win. Roberto Firmino (43’) had put Liverpool ahead two minutes before stoppage time in the first half before Nathaniel Phillips (52’) doubled the lead in the second. Alex Oxlade-Chamberlain (88’) dazzled Burnley’s defense and left three players in shock after he fired home for his first goal of the season. It was the 3rd Premier League defeat in five games: WLWLL for Burnley. The Clarets haven’t been impressive in front of goal – scoring only 33 goals (0.89 gpg) this season. Sean Dyche’s 4—4—2 formation will see the duo consisting of Vydra and Chris Wood working together up-front in search of goals for Burnley. Robbie Brady, Kevin Long and Ashley Barnes are all ruled out of this tie while Nick Pope remains doubtful. Kevin Friend will officiate this tie while Lee Mason will serve as VAR. Matthew Wilkes will be the assistant VAR.",
"type": "preview",
"created_at": "2021-05-21 14:10:47",
"updated_at": "2021-05-21 14:10:47"
},
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
commentaries
Indicates if this fixture has commentaries available
attendance
Give information about the visitor attendance of the fixture
pitch
details
Optional additional information.
neutral_venue
Indicates if the fixture was played at a neutral fixture. This often happens in cup finals
formations
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
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
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.
GET Standings Corrections by Season ID
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.
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 ID
GET Team by ID
https://soccer.sportmonks.com/api/v2.0/teams/{ID}
Endpoint details
Authorization
API Key
Pagination
NO
Allowed nested includes
3
Parameters
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.
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 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.
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 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.
GET Standings by Season and Date(time)
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.
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 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.
Search Team by Name
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.
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:
Includes are the cornerstone of our API and allow you to enrich and customize your requests. This flexibility is what distinguishes us from our competitors.
You can learn more about what includes are and how they work here:
Example response
Topscorers
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.
Includes are the cornerstone of our API and allow you to enrich and customize your requests. This flexibility is what distinguishes us from our competitors.
You can learn more about what includes are and how they work here:
Example response
Players
The Players endpoint provides you detailed Player information. With this endpoint you will be able to build completePlayer Profiles.
By using for example the Stats include it is possible to see the progression of the Player over the currentdomesticseason. Those are also available for historic Seasons, starting from 2017.
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:
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.
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
Rivals
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=rivalson our teams endpoint.
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:
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 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.
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:
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 unique player id of the player in that position in the stage
team_id
The unique id of the the player plays for
stage_id
The unique id of the current stage
goals
The total number of goals the player has scored in the stage
penalty_goals
The total number of penalty goals the player has scored in the stage
type
The type of the standings. Possible values are: goals, cards or assists
Rounds
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.
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
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
Check this endpoint in Postman.
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
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'
Enrich the API with more data and/or nested includes. Can be used by adding &include= to your request url.
Include options
fixturesresultsseasonleague
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:
Enrich the API with more data and/or nested includes. Can be used by adding &include= to your request url.
Include options
fixturesresultsseasonleague
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:
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.
Leagues and Seasons all over the world can have a different set up. The Stages endpoint can help you to define the current Stage or set up of multiple Stages of a particular League/Season.
Stage names are for example Regular Season, Play-offs, Semi-Finals, Final etc.
Check this endpoint in Postman.
Check this endpoint in Postman.
Check this endpoint in Postman.
Check this endpoint in Postman.
Check this endpoint in Postman.
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 (live) as well.
Enrich the API with more data and/or nested includes. Can be used by adding &include= to your request url.
Include options
fixturesresultsseasonleague
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.
Coaches
The Coaches endpoint provides you details about the Coach like the Name, Nationality Birthdate etc.
By default this endpoint returns Coach details that have managed at least one game in the Leagues covered by the Plan you are subscribed to.
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.
Enrich the API with more data and/or nested includes. Can be used by adding &include= to your request url.
Include options
fixturesresultsseasonleague
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:
Since November 2017 we offer the ability to load historical Squads. This means you can retrieve Squads from 2005 onwards, including Player performance of the Games of the requested Season.
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.
TV Stations
The TV Stations endpoint is about TV Stations broadcasting the Football Games. Per Fixture, the endpoint returns all TV Stations that broadcast the requested Game.
Enrich the API with more data and/or nested includes. Can be used by adding &include= etc to your request url.
Include options
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:
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.visitorTeamare often used here.
Another option that is highly popular is adding the relationship include&include=probabilityto your requests from the Fixture endpoint or Livescore endpoint. You can find more info in the relationship section about fixture probabilities.
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!
GET Value Bet by Fixture ID
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_oddcalculated by the Value Bet algorithm. Therefore, not every match has a Value Bet available.
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 ID
Parameters
Include options
fixture
Includes are the cornerstone of our API and allow you to enrich and customize your requests. This flexibility is what distinguishes us from our competitors.
You can learn more about what includes are and how they work here:
Example response
GET Probabilities by Fixture ID
GET Probabilities by Fixture ID
Parameters
Include options
fixture
Includes are the cornerstone of our API and allow you to enrich and customize your requests. This flexibility is what distinguishes us from our competitors.
You can learn more about what includes are and how they work here:
Example response
GET Value Bets
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_oddcalculated by the Value Bet algorithm. Therefore, not every match has a Value Bet available.
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 Bets
Parameters
Include options
fixture
Includes are the cornerstone of our API and allow you to enrich and customize your requests. This flexibility is what distinguishes us from our competitors.
You can learn more about what includes are and how they work here:
Example response
Check this endpoint in Postman.
Welcome to Sportmonks’ . 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 that can be used to request football data from our wide-ranging database and has the following characteristics:
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.
It is possible to use the 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.
Check this endpoint in Postman.
Check this endpoint in Postman.
Besides the , 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.
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 .
