arrow-left

Only this pageAll pages
gitbookPowered by GitBook
triangle-exclamation
Couldn't generate the PDF for 168 pages, generation stopped at 100.
Extend with 50 more pages.
1 of 100

Football API Documentation

Loading...

Loading...

Getting Started

Loading...

Loading...

Endpoint overview

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Tutorials

Loading...

Changelog

hashtag
20.0.55 - 2022-01-14

hashtag
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}

hashtag
2.0.54 - 2021-08-02

hashtag
Added

  • Added new weather types. You can check an overview of all possible outcomes on our page.

  • Added the opportunity to retrieve all bookmakers by Fixture ID.

hashtag
2.0.54 - 2021-07-05

hashtag
Added

  • Added 'is_friendly' property on league related responses or includes. This indicates if the league is friendly.

hashtag
2.0.53 - 2021-06-23

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

hashtag
2.0.52 - 2021-06-06

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

hashtag
2.0.51 - 2021-05-06

hashtag
Added

  • Added the News API (BETA) for the English Premier League and European Championship.

  • Added 20 new leagues, including the UEFA Conference League (ID: 2286). You can check all leagues on our .

hashtag
2.0.51 - 2021-04-06

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

hashtag

Welcome

Here you will find everything you need to know about Sportmonks’ Football API 2.0 (Deprecated).

triangle-exclamation

This version of the API is deprecated. Please visit the of our brand new API 3.0

Welcome to the documentation overview of Sportmonks' APIsarrow-up-right. We'll briefly inform you about the features of our API and then you can explore our documentation for yourself.

hashtag
Quick starts

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

circle-info

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.

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.

Statuses and Defintion
coverage pagearrow-up-right
Introduction to our APIchevron-right
Get Started with our how-to guideschevron-right
Livescores & fixtureschevron-right
arrow-up-right
Getting Started section
Documentation Organization section
API References Guidearrow-up-right
[email protected]envelope

Countries

hashtag
Countries

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.

GET All Countrieschevron-rightGET Country by IDchevron-right

circle-info

Check this endpoint in Postman.

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.

Get Video Highlights by Fixture IDchevron-right
circle-info

Check this endpoint in Postman.

Statistics

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 .

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

Venues

The Venue endpoint provides Venue information like Name, City, Capacity, Address and even a Venue image.

circle-info

Check this endpoint in Postman.

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.

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.

circle-info

Check this endpoint in Postman.

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.

circle-info

Check this endpoint in Postman.

In the tutorial below, we will go through every option one by one.
tutorialsarrow-up-right
how-to guidesarrow-up-right
Statisticschevron-right
Includeschevron-right

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.

circle-info

Please note that you can also use&include=rivalson our teams endpoint.

circle-info

Check this endpoint in Postman. arrow-up-right

GET All Leagueschevron-right
GET League by IDchevron-right
Search Leagues by Namechevron-right
arrow-up-right
arrow-up-right
GET Venue by IDchevron-right
GET Venues by Season IDchevron-right
arrow-up-right
arrow-up-right
Commentaries by Fixture IDchevron-right
arrow-up-right

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.

circle-info

In the the fixtures will be available 15 minutes before the match has started and 15 mins after it has ended.

circle-info

Check this endpoint in Postman.

Teams

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 IDchevron-rightGET Teams by Season IDchevron-rightSearch Team by Namechevron-rightGET Current Leagues by Team IDchevron-rightGet All Leagues by Team IDchevron-right
circle-info

Check this endpoint in Postman. arrow-up-right

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.

circle-info

Check this endpoint in Postman.

Stages

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.

GET Stage by IDchevron-rightGET Stages by Season IDchevron-right
circle-info

Check this endpoint in Postman. arrow-up-right

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 IDchevron-rightGET LIVE Standingschevron-rightGET Standings by Season ID and Round IDchevron-rightGET Standings by Season and Date(time)chevron-rightGET Standings Corrections by Season IDchevron-right
circle-info

Check this endpoint in Postman. arrow-up-right

Markets

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.

GET All Marketschevron-rightGET Market by IDchevron-right
circle-info

Check this endpoint in Postman. arrow-up-right

Team Squads

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.

GET Team Squad by Team and Season IDchevron-right
circle-info

Check this endpoint in Postman. arrow-up-right

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.

GET TV Station by Fixture IDchevron-right
circle-info

Check this endpoint in Postman. arrow-up-right

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.

GET Coach by IDchevron-right
circle-info

Check this endpoint in Postman. arrow-up-right

Bookmakers

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.

GET All Bookmakerschevron-rightGET Bookmaker by IDchevron-right
circle-info

Check this endpoint in Postman. arrow-up-right

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.

GET Topscorers by Season IDchevron-rightGET Topscorers Aggregated by Season IDchevron-right
circle-info

Check this endpoint in Postman. arrow-up-right

Run in Postman
docs

Documentation for the documentation

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:

GET News For Upcoming Fixtures

hashtag
GET News of all upcoming 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.

GET Continent by ID

hashtag
GET Continent by ID

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.

circle-info

Check this endpoint in Postman.

Players

The Players endpoint provides you detailed Player information. With this endpoint you will be able to build complete Player Profiles.

By using for example the Stats include it is possible to see the progression of the Player over the current domestic season. Those are also available for historic Seasons, starting from 2017.

circle-info

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.

circle-info

Check this endpoint in Postman.

Seasons

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.

circle-info

Check this endpoint in Postman.

Odds

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.

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.

circle-info

Introduction to our API

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:

  • Highly customizable requests

GET Bookmaker by ID

hashtag
GET Bookmaker by ID

API referencesarrow-up-right

  • Generalarrow-up-right

  • Getting helparrow-up-right

  • So, yes. This is indeed a documentation page about our documentation! Our documentation sections are classified based on our users' capabilities.

    The tutorial section, for instance, is mostly aimed at users without a technical/programming background. There, we show you basic requests and explain how you can use the many features of our API. The how-to guide section is aimed at more advanced users. Ideally, you'd have read through the tutorial section first before attempting to work yourself through the how-to guides. The how-to guides will show you how to send the right requests to get the API data you need for your own livescore page, match page with odds or fantasy gamearrow-up-right.

    Finally, the API References, are the most common resources used by developers already familiar with APIs. We also provide our API references in Postmanarrow-up-right.

    This way, you'll know where and how to navigate through our massive documentation. Good luck!

    Want to know more about who we are?

    circle-info

    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 [email protected]envelope.

    get started guide
    Tutorials
    How-to guides
    Run in Postman
    Run in Postman
    Run in Postman
    Run in Postman
    Run in Postman

    Authorization

    API Key

    Pagination

    YES

    Allowed nested includes

    10

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

    hashtag
    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:

    hashtag
    Example response

    https://soccer.sportmonks.com/api/v2.0/news/fixtures?api_token={API_TOKE
    circle-info

    Please note that you can also use the news include on our fixtures and livescores endpoints.

    Endpoint details

    Includeschevron-right
    file-pdf
    77KB
    News API.pdf
    PDF
    arrow-up-right-from-squareOpen
    EURO2020 Final Italy - England: News Response
    https://soccer.sportmonks.com/api/v2.0/news/fixtures/upcoming

    3

    Authorization

    API Key

    hashtag
    Parameters

    Available parameters

    page

    The number of the page you want to browse. Can be used by adding &page=2 etc to your request url.

    include

    Enrich the API with more data and/or nested includes. Can be used by adding &include= etc. to your request url.

    hashtag
    Include options

    countries

    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.

    hashtag
    Example response

    https://soccer.sportmonks.com/api/v2.0/continents/1?api_token={API_TOKEN}
     "data": {
            "id": 
    
    circle-info

    Check this endpoint in Postman. arrow-up-right

    Endpoint details

    Pagination

    YES

    Allowed nested includes

    Includeschevron-right
    Check this endpoint in Postman. arrow-up-right
    GET Player by IDchevron-right
    Search Player by Namechevron-right
    Check this endpoint in Postman.
    In-Play Odds arrow-up-right
    GET Odds by Fixture ID and Bookmaker IDchevron-right
    GET Odds by Fixture ID and Market IDchevron-right
    GET Odds by Fixture IDchevron-right
    GET Inplay Odds by Fixture IDchevron-right
    arrow-up-right
    Incredibly fast livescores
  • Reliable and accurate data

  • You will find valuable tutorials and how-to guides to help you kickstart your application on these documentation pages. Let's get started right away by making your first request!

    circle-info

    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. arrow-up-right

    Football APIarrow-up-right
    REST APIarrow-up-right
    Make your first requestchevron-right

    NO

    Allowed nested includes

    0

    hashtag
    Parameters

    No parameters available for this endpoint.

    hashtag
    Include options

    No includes available for this endpoint.

    hashtag
    Example response

    https://soccer.sportmonks.com/api/v2.0/bookmakers/1?api_token={API_TOKEN}
        "data": {
            "id":
    
    circle-info

    Check this endpoint in Postman. arrow-up-right

    Endpoint details

    Authorization

    API Key

    Pagination

    livescores endpoint,arrow-up-right
    GET All Livescoreschevron-right
    GET All In play Livescoreschevron-right
    arrow-up-right
    arrow-up-right
    GET All Continentschevron-right
    GET Continent by IDchevron-right
    arrow-up-right
    GET Head 2 Head by Team IDschevron-right
    arrow-up-right
    GET All Seasonschevron-right
    GET Season by IDchevron-right
    arrow-up-right

    GET Season by ID

    hashtag
    GET Season by ID

    Endpoint details

    Authorization

    API Key

    hashtag
    Parameters

    hashtag
    Include options

    league stages rounds upcoming results groups goalscorers cardscorers assistscorers aggregatedGoalscorers aggregatedCardscorers aggregatedAssistscorers fixtures

    Includes are the cornerstone of our API and allow you to enrich and customize your requests. This flexibility is what distinguishes us from our competitors.

    You can learn more about what includes are and how they work here:

    hashtag
    Example response

    circle-info

    Check this endpoint in Postman.

    GET Venue by ID

    hashtag
    GET Venue by ID

    Endpoint details

    Authorization

    API Key

    hashtag
    Parameters

    No parameters available for this endpoint.

    hashtag
    Include options

    No includes available for this endpoint.

    hashtag
    Example response

    circle-info

    Check this endpoint in Postman.

    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.

    https://soccer.sportmonks.com/api/v2.0/fixtures/18155734?api_token={API_TOKEN}&include=news
    "news": {
                "data": [
    
    file-pdf
    94KB
    News API Example.pdf
    PDF
    arrow-up-right-from-squareOpen
    EURO2020 Final Italy - England: News Response
    GET All Newschevron-rightGET News For Upcoming Fixtureschevron-right

    GET News by Season IDchevron-right

    GET Coach by ID

    hashtag
    GET Coach by ID

    Endpoint details

    Authorization

    API Key

    hashtag
    Parameters

    No parameters available for this endpoint.

    hashtag
    Include options

    No includes available for this endpoint.

    hashtag
    Example response

    circle-info

    Check this endpoint in Postman.

    Prediction API

    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.

    GET Leagues and Performanceschevron-rightGET Probabilitieschevron-rightGET Probabilities by Fixture IDchevron-rightGET Value Betschevron-rightGET Value Bet by Fixture IDchevron-right
    circle-info

    Check this endpoint in Postman.

    GET Stage by ID

    hashtag
    GET Stage by ID

    GET Country by ID

    hashtag
    GET Country by ID

    GET Market by ID

    hashtag
    GET Market by ID

    https://soccer.sportmonks.com/api/v2.0/continents/{ID}
    https://soccer.sportmonks.com/api/v2.0/bookmakers/{ID}
    https://soccer.sportmonks.com/api/v2.0/seasons/{ID}
    https://soccer.sportmonks.com/api/v2.0/venues/{ID}
    https://soccer.sportmonks.com/api/v2.0/coaches/{ID}
    {
    "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"
    Run in Postman
    Run in Postman
    Run in Postman
    Run in Postman
    Run in Postman
    Run in Postman
    Run in Postman
    Run in Postman
    Run in Postman
    Run in Postman
    Run in Postman
    Run in Postman
    Run in Postman
    Run in Postman
    Run in Postman

    is_current_season

    Indicates if the season is the current one. Possible values are "true" or "false"

    current_round_id

    The unique id of the current round

    current_stage_id

    The unique id of the current stage

    Pagination

    NO

    Allowed nested includes

    4

    Available parameters

    include

    Enrich the API with more data and/or nested includes. Can be used by adding &include= etc. to your request url.

    Field

    Description

    data

    Opens an array of data you've requested

    id

    The unique season id

    name

    The name of the season

    league_id

    https://soccer.sportmonks.com/api/v2.0/seasons/18346/api_token={API_TOKEN}
    Includeschevron-right
    arrow-up-right
    "data": {
            "id": 18346,
            "name": "2021/2022",
            "league_id": 2,
            "is_current_season": true,
            "current_round_id": null,
            "current_stage_id": 77453623
        }

    The unique league id the season belongs to

    1
    ,
    "name": "Europe"
    }
    1
    ,
    "name": "10Bet",
    "logo": null
    },

    NO

    Allowed nested includes

    2

    hashtag
    Parameters

    Available parameters

    include

    Enrich the API with more data and/or nested includes. Can be used by adding &include= to your request url.

    hashtag
    Include options

    fixtures results season league

    Includes are the cornerstone of our API and allow you to enrich and customize your requests. This flexibility is what distinguishes us from our competitors.

    You can learn more about what includes are and how they work here:

    hashtag
    Example response

    https://soccer.sportmonks.com/api/v2.0/stages/77447500?api_token={API_TOKEN}
       "data": {
            "id":
    

    Field

    Description

    id

    The unique id of the stage

    name

    The name of the stage

    type

    Indicates what kind of type the stage is

    league_id

    circle-info

    Check this endpoint in Postman. arrow-up-right

    Endpoint details

    Authorization

    API Key

    Pagination

    Includeschevron-right

    2

    Authorization

    API Key

    hashtag
    Parameters

    Available parameters

    page

    The number of the page you want to browse. Can be used by adding &page=2 etc to your request url.

    include

    Enrich the API with more data and/or nested includes. Can be used by adding &include= etc. to your request url.

    hashtag
    Include options

    leagues continent covid

    Includes are the cornerstone of our API and allow you to enrich and customize your requests. This flexibility is what distinguishes us from our competitors.

    You can learn more about what includes are and how they work here:

    hashtag
    Example response

    https://soccer.sportmonks.com/api/v2.0/countries/2?api_token={API_TOKEN}
    "data": {
            "id": 2
    
    circle-info

    Check this endpoint in Postman. arrow-up-right

    Endpoint details

    Pagination

    YES

    Allowed nested includes

    Includeschevron-right

    NO

    Allowed nested includes

    0

    hashtag
    Parameters

    No parameters available for this endpoint.

    hashtag
    Include options

    No includes available for this endpoint.

    hashtag
    Example response

    https://soccer.sportmonks.com/api/v2.0/markets/1?api_token={API_TOKEN}
        "data": {
            "id":
    
    circle-info

    Check this endpoint in Postman. arrow-up-right

    Endpoint details

    Authorization

    API Key

    Pagination

    Pagination

    NO

    Allowed nested includes

    0

    https://soccer.sportmonks.com/api/v2.0/venues/1?api_token={API_TOKEN}
    arrow-up-right
    "data": {
            "id": 1,
            "name": "Meadowbank Dorking",
            "surface": null,
            "address": null,
            "city": "Lviv",
            "capacity": 2000,
            "image_path": "https://cdn.sportmonks.com/images/soccer/venues/1/1.png",
            "coordinates": "51.234316,-0.33364"
        },

    Pagination

    NO

    Allowed nested includes

    0

    https://soccer.sportmonks.com/api/v2.0/coaches/1467946?api_token={API_TOKEN}
    arrow-up-right
    "data": {
            "coach_id": 1467946,
            "team_id": 53,
            "country_id": 491,
            "common_name": "N. Lennon",
            "fullname": "Neil Lennon",
            "firstname": "Neil",
            "lastname": "Lennon",
            "nationality": "Northern Ireland",
            "birthdate": "25/06/1971",
            "birthcountry": "Northern Ireland",
            "birthplace": "Lurgan",
            "image_path": "https://cdn.sportmonks.com/images/soccer/players/10/1467946.png"
        },
    arrow-up-right

    GET TV Station by Fixture ID

    hashtag
    GET TV Station by Fixture ID

    Endpoint details

    Authorization

    API Key

    hashtag
    Parameters

    No parameters available for this endpoint.

    hashtag
    Include options

    No includes available for this endpoint.

    hashtag
    Example response

    circle-info

    Check this endpoint in Postman.

    GET Round by ID

    hashtag
    GET Rounds by ID

    Endpoint details

    Authorization

    API Key

    hashtag
    Parameters

    hashtag
    Include options

    fixtures results season league

    Includes are the cornerstone of our API and allow you to enrich and customize your requests. This flexibility is what distinguishes us from our competitors.

    You can learn more about what includes are and how they work here:

    hashtag
    Example response

    circle-info

    Check this endpoint in Postman.

    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.

    It is possible to use the Value Bet API arrow-up-rightendpoint as described on this page. It will give you all Value Bets detected. It is also possible to use the Value Bet By Fixture Id.

    If you want to combine your Value Bets requests with your requests on the Fixture endpoint or Livescore endpoint, you can add the relationship include &include=valuebet. See the Relationship Fixture Value Bet for more info.

    hashtag
    Get Value Bet by Fixture ID

    hashtag
    Parameters

    hashtag
    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:

    hashtag
    Example response

    circle-info

    Check this endpoint in Postman.

    Get started with our video tutorial

    GET League by ID

    hashtag
    GET League by ID

    GET All News

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

    circle-info

    GET Stages by Season ID

    hashtag
    GET Stage by ID

    https://soccer.sportmonks.com/api/v2.0/stages/{ID}
    https://soccer.sportmonks.com/api/v2.0/country/{ID}
    https://soccer.sportmonks.com/api/v2.0/markets/{ID}
    https://soccer.sportmonks.com/api/v2.0/tvstations/fixture/{ID}
    https://soccer.sportmonks.com/api/v2.0/rounds/{ID}
    Run in Postman
    Run in Postman
    Run in Postman
    Run in Postman
    Run in Postman
    Run in Postman
    Run in Postman
    Run in Postman
    Please note that you can also use the news include on our fixtures and livescores endpoints.

    Endpoint details

    Authorization

    API Key

    Pagination

    YES

    Allowed nested includes

    10

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

    hashtag
    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:

    hashtag
    Example response

    Includeschevron-right
    file-pdf
    77KB
    News API.pdf
    PDF
    arrow-up-right-from-squareOpen
    EURO2020 Final Italy - England: News Response
    https://soccer.sportmonks.com/api/v2.0/news/fixtures?api_token={API_TOKEN}
        "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"
            },
    https://soccer.sportmonks.com/api/v2.0/news/fixtures

    stage_id

    The unique stage id the round belongs to

    start

    The start date of the round

    end

    The end date of the round

    Pagination

    NO

    Allowed nested includes

    2

    Available parameters

    include

    Enrich the API with more data and/or nested includes. Can be used by adding &include= to your request url.

    Field

    Description

    id

    The unique id of the round

    name

    The name of the round

    league_id

    The unique league id the round belongs to

    season_id

    
    https://soccer.sportmonks.com/api/v2.0/rounds/194968?api_token={API_TOKEN}
    Includeschevron-right
    arrow-up-right
       "data": {
            "id": 194968,
            "name": 1,
            "league_id": 501,
            "season_id": 17141,
            "stage_id": 77447501,
            "start": "2020-08-01",
            "end": "2020-08-03"
        }

    The unique season id the round belongs to

    77447500
    ,
    "name": "2nd Phase",
    "type": "Group Stage",
    "league_id": 501,
    "season_id": 17141,
    "sort_order": 2,
    "has_standings": true
    },

    The unique league id the stage belongs to

    season_id

    The unique season id the stage belongs to

    sort_order

    The order of the stages

    has_standings

    Indicates if the stage supports standings

    ,
    "name": "Poland",
    "image_path": "https://cdn.sportmonks.com/images/countries/png/short/pl.png",
    "extra": {
    "continent": "Europe",
    "sub_region": "Eastern Europe",
    "world_region": "EMEA",
    "fifa": "POL",
    "iso": "POL",
    "iso2": "PL",
    "longitude": "19.37775993347168",
    "latitude": "52.147850036621094",
    "flag": "<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"1280\" height=\"800\" viewBox=\"0 0 16 10\"><path fill=\"#fff\" d=\"M0 0h16v10h-16z\"/><path fill=\"#dc143c\" d=\"M0 5h16v5h-16z\"/></svg>\n"
    }
    }
    1
    ,
    "name": "3Way Result"
    },

    NO

    Allowed nested includes

    2

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

    hashtag
    Include options

    country season seasons

    Includes are the cornerstone of our API and allow you to enrich and customize your requests. This flexibility is what distinguishes us from our competitors.

    You can learn more about what includes are and how they work here:

    hashtag
    Example response

    https://soccer.sportmonks.com/api/v2.0/leagues/8?api_token={API_TOKEN}
    "data": {
            "id": 8
    

    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

    circle-info

    Check this endpoint in Postman. arrow-up-right

    Endpoint details

    Authorization

    API Key

    Pagination

    Includeschevron-right

    NO

    Allowed nested includes

    2

    hashtag
    Parameters

    Available parameters

    include

    Enrich the API with more data and/or nested includes. Can be used by adding &include= to your request url.

    hashtag
    Include options

    fixtures results season league

    Includes are the cornerstone of our API and allow you to enrich and customize your requests. This flexibility is what distinguishes us from our competitors.

    You can learn more about what includes are and how they work here:

    hashtag
    Example response

    https://soccer.sportmonks.com/api/v2.0/stages/season/17141?api_token={API_TOKEN}
      "data": [
            {
                "id
    

    Field

    Description

    id

    The unique id of the stage

    name

    The name of the stage

    type

    Indicates what kind of type the stage is

    league_id

    circle-info

    Check this endpoint in Postman. arrow-up-right

    Endpoint details

    Authorization

    API Key

    Pagination

    Pagination

    NO

    Allowed nested includes

    0

    https://soccer.sportmonks.com/api/v2.0/tvstations/fixture/16475287?api_token={API_TOKEN}
    arrow-up-right
       "data": [
            {
                "fixture_id": 16475287,
                "tvstation": "bet365"
            },
            {
                "fixture_id": 16475287,
                "tvstation": "BetClic.fr"
            },
            {
                "fixture_id": 16475287,
                "tvstation": "Chance"
            },
            {
                "fixture_id": 16475287,
                "tvstation": "Eleven Sports (Por)"
            },
            {
                "fixture_id": 16475287,
                "tvstation": "Fortuna"
            },
            {
                "fixture_id": 16475287,
                "tvstation": "Fortuna PL"
            },
            {
                "fixture_id": 16475287,
                "tvstation": "Fortuna SK"
            },
            {
                "fixture_id": 16475287,
                "tvstation": "Netbet"
            },
            {
                "fixture_id": 16475287,
                "tvstation": "Polsat Sport Extra"
            },
            {
                "fixture_id": 16475287,
                "tvstation": "PREMIER Sport (CZE)"
            },
            {
                "fixture_id": 16475287,
                "tvstation": "STS.pl"
            },
            {
                "fixture_id": 16475287,
                "tvstation": "Tipsport"
            },
            {
                "fixture_id": 16475287,
                "tvstation": "Tipsport SK"
            },
            {
                "fixture_id": 16475287,
                "tvstation": "Unibet FR"
            }
        ],

    Endpoint details

    Authorization

    API Key

    Pagination

    NO

    Allowed nested includes

    0

    Available parameters

    include

    Enrich the API with more data and/or nested includes. Can be used by adding &include= etc to your request url.

    arrow-up-right
    Run in Postman

    GET Odds by Fixture ID and Bookmaker ID

    hashtag
    GET Odds by Fixture ID and Bookmaker ID

    Endpoint details

    Authorization

    API Key

    hashtag
    Parameters

    No parameters available for this endpoint.

    hashtag
    Include options

    No includes available for this endpoint.

    hashtag
    Example response

    circle-info

    Check this endpoint in Postman.

    GET Player by ID

    hashtag
    GET Player by ID

    Endpoint details

    Authorization

    API Key

    hashtag
    Parameters

    hashtag
    Include options

    position team stats trophies sidelined transfers lineups country

    Includes are the cornerstone of our API and allow you to enrich and customize your requests. This flexibility is what distinguishes us from our competitors.

    You can learn more about what includes are and how they work here:

    hashtag
    Example response

    circle-info

    Check this endpoint in Postman.

    GET Odds by Fixture ID and Market ID

    hashtag
    GET Odds by Fixture ID and Market ID

    Endpoint details

    Authorization

    API Key

    hashtag
    Parameters

    No parameters available for this endpoint.

    hashtag
    Include options

    No includes available for this endpoint.

    hashtag
    Example response

    circle-info

    Check this endpoint in Postman.

    Commentaries by Fixture ID

    hashtag
    Get Commentaries by Fixture ID

    Endpoint details

    Authorization

    API Key

    hashtag
    Parameters

    No parameters available for this endpoint.

    hashtag
    Include options

    No includes available for this endpoint.

    hashtag
    Example response

    circle-info

    Check this endpoint in Postman.

    GET All Bookmakers

    hashtag
    GET All Bookmakers

    Endpoint details

    Authorization

    API Key

    hashtag
    Parameters

    No parameters available for this endpoint.

    hashtag
    Include options

    No includes available for this endpoint.

    hashtag
    Example response

    circle-info

    Check this endpoint in Postman.

    GET All Bookmakers by Fixture ID

    hashtag
    GET All Bookmakers by Fixture ID

    Endpoint details

    Authorization

    API Key

    hashtag
    Parameters

    No parameters available for this endpoint.

    hashtag
    Include options

    No includes available for this endpoint.

    hashtag
    Example response

    circle-info

    Check this endpoint in Postman.

    Get Video Highlights by Fixture ID

    hashtag
    Get Video Highlights by Fixture ID

    Endpoint details

    Authorization

    API Key

    hashtag
    Parameters

    No parameters available for this endpoint.

    hashtag
    Include options

    fixture

    You can learn more about what includes are and how they work here:

    hashtag
    Example response

    circle-info

    Check this endpoint in Postman.

    GET Probabilities by Fixture ID

    hashtag
    GET Probabilities by Fixture ID

    Endpoint details

    Authorization

    API Key

    hashtag
    Parameters

    hashtag
    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:

    hashtag
    Example response

    circle-info

    Check this endpoint in Postman.

    GET All Markets

    hashtag
    GET All Markets

    Endpoint details

    Authorization

    API Key

    hashtag
    Parameters

    No parameters available for this endpoint.

    hashtag
    Include options

    No includes available for this endpoint.

    hashtag
    Example response

    circle-info

    Check this endpoint in Postman.

    GET Inplay Odds by Fixture ID

    hashtag
    GET Inplay Odds by Fixture ID

    GET Odds by Fixture ID

    hashtag
    GET Odds by Fixture ID

    GET News by Season ID

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

    GET Team by ID

    hashtag
    GET Team by ID

    https://soccer.sportmonks.com/api/v2.0/leagues/{ID}
    https://soccer.sportmonks.com/api/v2.0/stages/season/{ID}
    https://soccer.sportmonks.com/api/v2.0/predictions/valuebets/fixture/{fixture_ID}
    https://soccer.sportmonks.com/api/v2.0/predictions/valuebets/fixture/16475287?api_token={API_TOKEN}
        "data": {
            "fixture_id": 16475287,
            "predictions": {
                "bet": "1",
                "bookmaker": "dafabet",
                "odd": 1.1,
                "stake": 3.66,
                "fair_odd": 1.09
            }
        },
    https://soccer.sportmonks.com/api/v2.0/odds/fixture/{fixture_ID}/bookmaker/{bookmaker_ID}
    https://soccer.sportmonks.com/api/v2.0/players/{ID}
    https://soccer.sportmonks.com/api/v2.0/odds/fixture/{fixture_ID}/market/{market_ID}
    https://soccer.sportmonks.com/api/v2.0/commentaries/fixture/{ID}
    https://soccer.sportmonks.com/api/v2.0/bookmakers
    https://soccer.sportmonks.com/api/v2.0/bookmakers/fixture/{ID}
    https://soccer.sportmonks.com/api/v2.0/highlights/fixture/{ID}
    https://soccer.sportmonks.com/api/v2.0/predictions/probabilities/fixture/{ID}
    https://soccer.sportmonks.com/api/v2.0/markets
    Run in Postman
    Run in Postman
    Run in Postman
    Run in Postman
    Run in Postman
    Run in Postman

    Authorization

    API Key

    Pagination

    YES

    Allowed nested includes

    10

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

    hashtag
    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:

    circle-info

    Please note that you can also use the news include on our fixtures and livescores endpoints.

    hashtag
    Example response

    Endpoint details

    Includeschevron-right
    file-download
    6KB
    News.json
    arrow-up-right-from-squareOpen
    EURO2020 Final Italy - England: News response
    https://soccer.sportmonks.com/api/v2.0/news/seasons/17420?api_token={API_TOKEN}
      "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"
            },
    https://soccer.sportmonks.com/api/v2.0/news/seasons/{ID}

    common_name

    The common name the player is known for

    display_name

    The display name of the player. Often used to show in the lineup formation

    fullname

    The full name of the player

    firstname

    The first name of the player

    lastname

    The last name of the player

    nationality

    The nationality of the player

    birthdate

    The date of birth of the player

    birthcountry

    The country the player was born in

    birthplace

    The place the player was born in

    height

    The height of the player

    weight

    The weight of the player

    image_path

    The URL of the player image

    Pagination

    NO

    Allowed nested includes

    2

    Available parameters

    include

    Enrich the API with more data and/or nested includes. Can be used by adding &include= to your request url.

    Field

    Description

    player_id

    The unique id of the main player

    team_id

    The unique id of the team the player belongs to

    country_id

    The unique id of the country the player is from

    position_id

    https://soccer.sportmonks.com/api/v2.0/players/172104?api_token={API_TOKEN}
    Includeschevron-right
    arrow-up-right
       "data": {
            "player_id": 172104,
            "team_id": 53,
            "country_id": 1161,
            "position_id": 3,
            "common_name": "J. Forrest",
            "display_name": "James Forrest",
            "fullname": "James Forrest",
            "firstname": "James",
            "lastname": "Forrest",
            "nationality": "Scotland",
            "birthdate": "07/07/1991",
            "birthcountry": "Scotland",
            "birthplace": "Prestwick",
            "height": "175 cm",
            "weight": null,
            "image_path": "https://cdn.sportmonks.com/images/soccer/players/8/172104.png"
        },

    The unique id of the position the player plays in

    ,
    "active": true,
    "type": "domestic",
    "legacy_id": 29,
    "country_id": 462,
    "logo_path": "https://cdn.sportmonks.com/images/soccer/leagues/8/8.png",
    "name": "Premier League",
    "is_cup": false,
    "is_friendly": false,
    "current_season_id": 18378,
    "current_round_id": null,
    "current_stage_id": 77453700,
    "live_standings": true,
    "coverage": {
    "predictions": true,
    "topscorer_goals": true,
    "topscorer_assists": true,
    "topscorer_cards": true
    }
    },

    Indicates what kind of league this is. Possible values: 'domestic', 'cup', 'international'. More values can be found here

    legacy_id

    This was for our API version 1.0. It's only of use for old users of our API

    country_id

    The unique country id the league is played in

    logo_path

    The logo URL path of the league

    name

    The name of the league

    is_cup

    Indicates if the league is a cup or not. Possible values are 'true' or 'false'

    current_season_id

    The unique id of the current season

    current_round_id

    The unique id of the current round

    current_stage_id

    The unique id of the current stage

    live_standings

    Indicates if the league covers live standings

    coverage

    Opens an array of partial coverage for the league

    predictions

    Indicates if the league covers predictions

    topscorers_goals

    Indicates if the league covers goal topscorers

    topscorers_assists

    Indicates if the league covers assists topscorers

    topscorers_cards

    Indicates if the league covers cards topscorers

    "
    :
    77447500
    ,
    "name": "2nd Phase",
    "type": "Group Stage",
    "league_id": 501,
    "season_id": 17141,
    "sort_order": 2,
    "has_standings": true
    },
    {
    "id": 77447501,
    "name": "1st Phase",
    "type": "Group Stage",
    "league_id": 501,
    "season_id": 17141,
    "sort_order": 1,
    "has_standings": true
    }
    ],

    The unique league id the stage belongs to

    season_id

    The unique season id the stage belongs to

    sort_order

    The order of the stages

    has_standings

    Indicates if the stage supports standing

    NO

    Allowed nested includes

    0

    hashtag
    Parameters

    No parameters available for this endpoint.

    hashtag
    Include options

    No includes available for this endpoint.

    hashtag
    Example response

    https://soccer.sportmonks.com/api/v2.0/odds/inplay/fixture/11865351?api_token={API_TOKEN}
     "data": [
            {
                "id
    
    circle-info

    Check this endpoint in Postman. arrow-up-right

    Endpoint details

    Authorization

    API Key

    Pagination

    NO

    Allowed nested includes

    0

    hashtag
    Parameters

    No parameters available for this endpoint.

    hashtag
    Include options

    No includes available for this endpoint.

    hashtag
    Example response

    https://soccer.sportmonks.com/api/v2.0/odds/fixture/16475287?api_token={API_TOKEN}
        "data": [
            {
                "id
    
    circle-info

    Check this endpoint in Postman. arrow-up-right

    Endpoint details

    Authorization

    API Key

    Pagination

    NO

    Allowed nested includes

    3

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

    hashtag
    Include options

    country squad coach transfers sidelined stats venue fifaranking uefaranking visitorFixtures localFixtures visitorResults latest upcoming goalscorers cardscorers assistscorers aggregatedGoalscorers aggregatedCardscorers aggregatedAssistscorers league activeSeasons trophies rivals

    circle-info

    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:

    hashtag

    hashtag
    Example response

    Field

    Description

    id

    The unique id of the team

    legacy_id

    This was for our API version 1.0. It's only of use for old users of our API

    name

    The name of the team

    short_code

    circle-info

    Check this endpoint in Postman. arrow-up-right

    Endpoint details

    Authorization

    API Key

    Pagination

    Includeschevron-right

    Pagination

    NO

    Allowed nested includes

    0

    https://soccer.sportmonks.com/api/v2.0/odds/fixture/16475287/bookmaker/1?api_token={API_TOKEN}
    arrow-up-right
        "data": [
            {
                "id": 1,
                "name": "3Way Result",
                "suspended": false,
                "bookmaker": {
                    "data": [
                        {
                            "id": 1,
                            "name": "10Bet",
                            "odds": {
                                "data": [
                                    {
                                        "value": "1.05",
                                        "handicap": null,
                                        "total": null,
                                        "label": "1",
                                        "probability": "95.24%",
                                        "dp3": "1.050",
                                        "american": -2000,
                                        "factional": null,
                                        "winning": true,
                                        "stop": false,
                                        "bookmaker_event_id": "47773472",
                                        "last_update": {
                                            "date": "2020-08-02 15:20:16.425924",
                                            "timezone_type": 3,
                                            "timezone": "UTC"
                                        }
                                    },
                                    {
                                        "value": "13.75",
                                        "handicap": null,
                                        "total": null,
                                        "label": "X",
                                        "probability": "7.27%",
                                        "dp3": "13.750",
                                        "american": 1275,
                                        "factional": null,
                                        "winning": false,
                                        "stop": false,
                                        "bookmaker_event_id": "47773472",
                                        "last_update": {
                                            "date": "2020-08-02 15:20:16.425958",
                                            "timezone_type": 3,
                                            "timezone": "UTC"
                                        }
                                    },
                                    {
                                        "value": "25.25",
                                        "handicap": null,
                                        "total": null,
                                        "label": "2",
                                        "probability": "3.96%",
                                        "dp3": "25.250",
                                        "american": 2425,
                                        "factional": null,
                                        "winning": false,
                                        "stop": false,
                                        "bookmaker_event_id": "47773472",
                                        "last_update": {
                                            "date": "2020-08-02 15:20:16.425974",
                                            "timezone_type": 3,
                                            "timezone": "UTC"
                                        }
                                    }
                                ]
                            }
                        }
                    ]
                }
            },
            {
                "id": 10,
                "name": "Home/Away",
                "suspended": false,
                "bookmaker": {
                    "data": [
                        {
                            "id": 1,
                            "name": "10Bet",
                            "odds": {
                                "data": [
                                    {
                                        "value": "21.50",
                                        "handicap": null,
                                        "total": null,
                                        "label": "2",
                                        "probability": "4.65%",
                                        "dp3": "21.500",
                                        "american": 2050,
                                        "factional": null,
                                        "winning": false,
                                        "stop": false,
                                        "bookmaker_event_id": "47773472",
                                        "last_update": {
                                            "date": "2020-08-02 15:20:16.610442",
                                            "timezone_type": 3,
                                            "timezone": "UTC"
                                        }
                                    }
                                ]
                            }
                        }
                    ]
                }
            },

    Pagination

    NO

    Allowed nested includes

    0

    https://soccer.sportmonks.com/api/v2.0/odds/fixture/16475287/market/1?api_token={API_TOKEN}
    arrow-up-right
    "data": [
            {
                "id": 1,
                "name": "3Way Result",
                "suspended": false,
                "bookmaker": {
                    "data": [
                        {
                            "id": 2,
                            "name": "bet365",
                            "odds": {
                                "data": [
                                    {
                                        "label": "1",
                                        "value": "1.05",
                                        "probability": "95.24%",
                                        "dp3": "1.050",
                                        "american": -2000,
                                        "factional": null,
                                        "winning": true,
                                        "handicap": null,
                                        "total": null,
                                        "bookmaker_event_id": null,
                                        "last_update": {
                                            "date": "2020-08-02 13:56:17.000000",
                                            "timezone_type": 3,
                                            "timezone": "UTC"
                                        }
                                    },
                                    {
                                        "label": "X",
                                        "value": "13.00",
                                        "probability": "7.69%",
                                        "dp3": "13.000",
                                        "american": 1200,
                                        "factional": null,
                                        "winning": false,
                                        "handicap": null,
                                        "total": null,
                                        "bookmaker_event_id": null,
                                        "last_update": {
                                            "date": "2020-08-02 13:56:17.000000",
                                            "timezone_type": 3,
                                            "timezone": "UTC"
                                        }
                                    },
                                    {
                                        "label": "2",
                                        "value": "23.00",
                                        "probability": "4.35%",
                                        "dp3": "23.000",
                                        "american": 2200,
                                        "factional": null,
                                        "winning": false,
                                        "handicap": null,
                                        "total": null,
                                        "bookmaker_event_id": null,
                                        "last_update": {
                                            "date": "2020-08-02 13:56:17.000000",
                                            "timezone_type": 3,
                                            "timezone": "UTC"
                                        }
                                    }
                                ]
                            }
                        },
                        {
                            "id": 27802,
                            "name": "Ladbrokes",
                            "odds": {
                                "data": [
                                    {
                                        "label": "1",
                                        "value": "1.06",
                                        "probability": "94.34%",
                                        "dp3": "1.060",
                                        "american": -1667,
                                        "factional": null,
                                        "winning": true,
                                        "handicap": null,
                                        "total": null,
                                        "bookmaker_event_id": null,
                                        "last_update": {
                                            "date": "2020-08-02 14:57:51.000000",
                                            "timezone_type": 3,
                                            "timezone": "UTC"
                                        }
                                    },
                                    {
                                        "label": "X",
                                        "value": "13.00",
                                        "probability": "7.69%",
                                        "dp3": "13.000",
                                        "american": 1200,
                                        "factional": null,
                                        "winning": false,
                                        "handicap": null,
                                        "total": null,
                                        "bookmaker_event_id": null,
                                        "last_update": {
                                            "date": "2020-08-02 14:57:51.000000",
                                            "timezone_type": 3,
                                            "timezone": "UTC"
                                        }
                                    },
                                    {
                                        "label": "2",
                                        "value": "41.00",
                                        "probability": "2.44%",
                                        "dp3": "41.000",
                                        "american": 4000,
                                        "factional": null,
                                        "winning": false,
                                        "handicap": null,
                                        "total": null,
                                        "bookmaker_event_id": null,
                                        "last_update": {
                                            "date": "2020-08-02 14:57:51.000000",
                                            "timezone_type": 3,
                                            "timezone": "UTC"
                                        }
                                    }
                                ]
                            }
                        },

    Pagination

    NO

    Allowed nested includes

    0

    https://soccer.sportmonks.com/api/v2.0/commentaries/fixture/16924614&api_token={API_TOKEN}
    arrow-up-right
    "data": [
            {
                "fixture_id": 16924614,
                "important": false,
                "order": 80,
                "goal": false,
                "minute": 0,
                "extra_minute": null,
                "comment": "Thats all. Game finished -  Wolverhampton Wanderers 1, Manchester City 3."
            },
            {
                "fixture_id": 16924614,
                "important": false,
                "order": 79,
                "goal": false,
                "minute": 90,
                "extra_minute": 6,
                "comment": "Second Half ended - Wolverhampton Wanderers 1, Manchester City 3."
            },
            {
                "fixture_id": 16924614,
                "important": true,
                "order": 78,
                "goal": true,
                "minute": 90,
                "extra_minute": 5,
                "comment": "Goal!  Wolverhampton Wanderers 1, Manchester City 3. Gabriel Jesus  - Manchester City -  shot with right foot from the left side of the box to the top left corner. Assist -  Kevin De Bruyne."
            },
            {
                "fixture_id": 16924614,
                "important": false,
                "order": 77,
                "goal": false,
                "minute": 90,
                "extra_minute": 4,
                "comment": "Corner -  Manchester City. Conceded by Rui Patrício."
            },
            {
                "fixture_id": 16924614,
                "important": false,
                "order": 76,
                "goal": false,
                "minute": 90,
                "extra_minute": 4,
                "comment": "New attacking attempt. Gabriel Jesus  - Manchester City -  shot with right foot from outside the box is saved in the left corner. Assist -  Kevin De Bruyne."
            },
            {
                "fixture_id": 16924614,
                "important": false,
                "order": 75,
                "goal": false,
                "minute": 90,
                "extra_minute": 1,
                "comment": "Corner -  Manchester City. Conceded by Conor Coady."
            },
            {
                "fixture_id": 16924614,
                "important": false,
                "order": 74,
                "goal": false,
                "minute": 89,
                "extra_minute": null,
                "comment": "Corner -  Wolverhampton Wanderers. Conceded by Fernandinho."
            },
            {
                "fixture_id": 16924614,
                "important": false,
                "order": 73,
                "goal": false,
                "minute": 88,
                "extra_minute": null,
                "comment": "Fouled by Benjamin Mendy  - Manchester City"
            },
            {
                "fixture_id": 16924614,
                "important": false,
                "order": 72,
                "goal": false,
                "minute": 88,
                "extra_minute": null,
                "comment": "Adama Traoré  - Wolverhampton Wanderers -  won a free kick on the right wing."
            },
            {
                "fixture_id": 16924614,
                "important": false,
                "order": 71,
                "goal": false,
                "minute": 87,
                "extra_minute": null,
                "comment": "Missed chance. Willy Boly  - Wolverhampton Wanderers -  shot with the head from the centre of the box goes high. Assist -  Rúben Neves ."
            },
            {
                "fixture_id": 16924614,
                "important": true,
                "order": 70,
                "goal": false,
                "minute": 86,
                "extra_minute": null,
                "comment": "Rodrigo  - Manchester City -  receive yellow card."
            },

    Pagination

    NO

    Allowed nested includes

    0

    https://soccer.sportmonks.com/api/v2.0/bookmakers?api_token={API_TOKEN}
    arrow-up-right
    "data": [
            {
                "id": 1,
                "name": "10Bet",
                "logo": null
            },
            {
                "id": 2,
                "name": "bet365",
                "logo": null
            },
            {
                "id": 3,
                "name": "188Bet",
                "logo": null
            },
            {
                "id": 5,
                "name": "5 Dimes",
                "logo": null
            },
            {
                "id": 7,
                "name": "888Sport",
                "logo": null
            },
            {
                "id": 9,
                "name": "BetFred",
                "logo": null
            },
            {
                "id": 11,
                "name": "Bet-At-Home",
                "logo": null
            },
            {
                "id": 13,
                "name": "BetCRIS",
                "logo": null
            },
            {
                "id": 15,
                "name": "Betfair",
                "logo": null
            },
            {
                "id": 17,
                "name": "BetOnline",
                "logo": null
            },
            {
                "id": 19,
                "name": "BetRedKings",
                "logo": null
            },
            {
                "id": 21,
                "name": "BetVictor",
                "logo": null
            },
            {
                "id": 23,
                "name": "Coral",
                "logo": null
            },
            {
                "id": 25,
                "name": "Dafabet",
                "logo": null
            },
            {
                "id": 27,
                "name": "Intertops",
                "logo": null
            },
            {
                "id": 36,
                "name": "Marathonbet",
                "logo": null
            },
            {
                "id": 44,
                "name": "Matchbook",
                "logo": null
            },
            {
                "id": 53,
                "name": "MyBet",
                "logo": null
            },
            {
                "id": 62,
                "name": "Paddy Power",
                "logo": null
            },
            {
                "id": 70,
                "name": "Pncl",
                "logo": null
            },

    Pagination

    NO

    Allowed nested includes

    0

    https://soccer.sportmonks.com/api/v2.0/bookmakers/fixture/16475287?api_token={API_TOKEN}
    arrow-up-right
        "data": [
            {
                "id": 1,
                "name": "10Bet",
                "logo": null
            },
            {
                "id": 2,
                "name": "bet365",
                "logo": null
            },
            {
                "id": 3,
                "name": "188Bet",
                "logo": null
            },
            {
                "id": 5,
                "name": "5 Dimes",
                "logo": null
            },
            {
                "id": 7,
                "name": "888Sport",
                "logo": null
            },
            {
                "id": 11,
                "name": "Bet-At-Home",
                "logo": null
            },
            {
                "id": 13,
                "name": "BetCRIS",
                "logo": null
            },
            {
                "id": 15,
                "name": "Betfair",
                "logo": null
            },
            {
                "id": 21,
                "name": "BetVictor",
                "logo": null
            },
            {
                "id": 23,
                "name": "Coral",
                "logo": null
            },
            {
                "id": 25,
                "name": "Dafabet",
                "logo": null
            },
            {
                "id": 27,
                "name": "Intertops",
                "logo": null
            },
            {
                "id": 36,
                "name": "Marathonbet",
                "logo": null
            },
            {
                "id": 44,
                "name": "Matchbook",
                "logo": null
            },
            {
                "id": 70,
                "name": "Pncl",
                "logo": null
            },
            {
                "id": 88,
                "name": "Tipico",
                "logo": null
            },
            {
                "id": 97,
                "name": "Unibet",
                "logo": null
            },
            {
                "id": 114,
                "name": "Betsson",
                "logo": null
            },
            {
                "id": 150,
                "name": "bwin",
                "logo": null
            },
            {
                "id": 187,
                "name": "WilliamHill",
                "logo": null
            },

    Pagination

    YES

    Allowed nested includes

    2

    https://soccer.sportmonks.com/api/v2.0/highlights/fixture/16924614&api_token={API_TOKEN}
    Includeschevron-right
    arrow-up-right
    "data": [
            {
                "fixture_id": 16924614,
                "event_id": null,
                "location": "https://cc.sporttube.com/embed/8T2CCCG",
                "type": "video",
                "created_at": {
                    "date": "2020-09-21 20:53:04.000000",
                    "timezone_type": 3,
                    "timezone": "UTC"
                }
            },
            {
                "fixture_id": 16924614,
                "event_id": null,
                "location": "https://cc.sporttube.com/embed/eT2CCCG",
                "type": "video",
                "created_at": {
                    "date": "2020-09-21 19:38:04.000000",
                    "timezone_type": 3,
                    "timezone": "UTC"
                }
            },
            {
                "fixture_id": 16924614,
                "event_id": null,
                "location": "https://cc.sporttube.com/embed/gT2CCCG",
                "type": "video",
                "created_at": {
                    "date": "2020-09-21 19:50:17.000000",
                    "timezone_type": 3,
                    "timezone": "UTC"
                }
            },
            {
                "fixture_id": 16924614,
                "event_id": null,
                "location": "https://cc.sporttube.com/embed/hT2CCCG",
                "type": "video",
                "created_at": {
                    "date": "2020-09-21 19:52:03.000000",
                    "timezone_type": 3,
                    "timezone": "UTC"
                }
            },
            {
                "fixture_id": 16924614,
                "event_id": null,
                "location": "https://cc.sporttube.com/embed/iT2CCCG",
                "type": "video",
                "created_at": {
                    "date": "2020-09-21 21:10:03.000000",
                    "timezone_type": 3,
                    "timezone": "UTC"
                }
            },
            {
                "fixture_id": 16924614,
                "event_id": null,
                "location": "https://cc.sporttube.com/embed/jT2CCCG",
                "type": "video",
                "created_at": {
                    "date": "2020-09-21 19:41:04.000000",
                    "timezone_type": 3,
                    "timezone": "UTC"
                }
            },
            {
                "fixture_id": 16924614,
                "event_id": null,
                "location": "https://cc.sporttube.com/embed/QT2CCCG",
                "type": "video",
                "created_at": {
                    "date": "2020-09-21 20:56:05.000000",
                    "timezone_type": 3,
                    "timezone": "UTC"
                }
            },
            {
                "fixture_id": 16924614,
                "event_id": null,
                "location": "https://cc.sporttube.com/embed/tT2CCCG",
                "type": "video",
                "created_at": {
                    "date": "2020-09-21 21:12:03.000000",
                    "timezone_type": 3,
                    "timezone": "UTC"
                }
            }
        ],

    Pagination

    NO

    Allowed nested includes

    0

    Available parameters

    include

    Enrich the API with more data and/or nested includes. Can be used by adding &include= etc to your request url.

    https://soccer.sportmonks.com/api/v2.0/predictions/probabilities/fixture/16475287?api_token={API_TOKEN}
    Includeschevron-right
    arrow-up-right
        "data": {
            "fixture_id": 16475287,
            "predictions": {
                "btts": 33.017,
                "over_2_5": 65.205,
                "under_2_5": 34.791,
                "over_3_5": 43.224,
                "under_3_5": 56.773,
                "HT_over_0_5": 94.655,
                "HT_under_0_5": 5.341,
                "HT_over_1_5": 79.003,
                "HT_under_1_5": 20.993,
                "AT_over_0_5": 34.88,
                "AT_under_0_5": 65.117,
                "AT_over_1_5": 6.946,
                "AT_under_1_5": 93.051,
                "home": 87.372,
                "away": 3.1929,
                "draw": 9.432,
                "correct_score": {
                    "0-0": 3.478,
                    "0-1": 1.492,
                    "0-2": 0.32,
                    "0-3": 0.046,
                    "0-4": 0.005,
                    "1-0": 10.19,
                    "1-1": 4.372,
                    "1-2": 0.938,
                    "1-3": 0.134,
                    "1-4": 0.014,
                    "1-5": 0.001,
                    "2-0": 14.93,
                    "2-1": 6.407,
                    "2-2": 1.374,
                    "2-3": 0.196,
                    "2-4": 0.021,
                    "2-5": 0.002,
                    "3-0": 14.59,
                    "3-1": 6.259,
                    "3-2": 1.342,
                    "3-3": 0.192,
                    "3-4": 0.021,
                    "3-5": 0.002,
                    "4-0": 10.69,
                    "4-1": 4.586,
                    "4-2": 0.984,
                    "4-3": 0.141,
                    "4-4": 0.015,
                    "4-5": 0.001,
                    "5-0": 6.266,
                    "5-1": 2.688,
                    "5-2": 0.576,
                    "5-3": 0.082,
                    "5-4": 0.009,
                    "5-5": 0.001,
                    "6-0": 3.06,
                    "6-1": 1.313,
                    "6-2": 0.282,
                    "6-3": 0.04,
                    "6-4": 0.004,
                    "7-0": 1.281,
                    "7-1": 0.55,
                    "7-2": 0.118,
                    "7-3": 0.017,
                    "7-4": 0.002,
                    "8-0": 0.469,
                    "8-1": 0.201,
                    "8-2": 0.043,
                    "8-3": 0.006,
                    "8-4": 0.001,
                    "9-0": 0.153,
                    "9-1": 0.066,
                    "9-2": 0.014,
                    "9-3": 0.002
                }
            }
        },

    Pagination

    NO

    Allowed nested includes

    0

    https://soccer.sportmonks.com/api/v2.0/markets?api_token={API_TOKEN}
    arrow-up-right
        "data": [
            {
                "id": 1,
                "name": "3Way Result"
            },
            {
                "id": 10,
                "name": "Home/Away"
            },
            {
                "id": 12,
                "name": "Over/Under"
            },
            {
                "id": 28,
                "name": "Asian Handicap"
            },
            {
                "id": 29,
                "name": "Asian Handicap Cards"
            },
            {
                "id": 30,
                "name": "Asian Total Cards"
            },
            {
                "id": 31,
                "name": "First Card Received"
            },
            {
                "id": 32,
                "name": "Time Of First Card"
            },
            {
                "id": 33,
                "name": "Team Cards"
            },
            {
                "id": 34,
                "name": "Corner Match Bet"
            },
            {
                "id": 35,
                "name": "Corner Handicap"
            },
            {
                "id": 36,
                "name": "Time Of First Corner"
            },
            {
                "id": 37,
                "name": "3Way Result 1st Half"
            },
            {
                "id": 38,
                "name": "Goals Over/Under 2nd Half"
            },
            {
                "id": 39,
                "name": "Team Corners"
            },
            {
                "id": 47,
                "name": "Over/Under 2nd Half"
            },
            {
                "id": 63,
                "name": "Double Chance"
            },
            {
                "id": 69,
                "name": "Team To Score First"
            },
            {
                "id": 75,
                "name": "Team To Score Last"
            },
            {
                "id": 80,
                "name": "3Way Result 2nd Half"
            },
            {
                "id": 83,
                "name": "Handicap Result"
            },
            {
                "id": 13343,
                "name": "Team Clean Sheet"
            },
            {
                "id": 28075,
                "name": "Fulltime Result"
            },
            {
                "id": 28076,
                "name": "To Win 2nd Half"
            },

    GET Leagues by Country ID

    hashtag
    GET League by Country ID

    Endpoint details

    Authorization

    API Key

    hashtag
    Parameters

    hashtag
    Include options

    country season seasons

    Includes are the cornerstone of our API and allow you to enrich and customize your requests. This flexibility is what distinguishes us from our competitors.

    You can learn more about what includes are and how they work here:

    hashtag
    Example response

    circle-info

    Check this endpoint in Postman.

    GET Rounds by Season ID

    hashtag
    GET Rounds by Season ID

    Endpoint details

    Authorization

    API Key

    hashtag
    Parameters

    hashtag
    Include options

    fixtures results season league

    Includes are the cornerstone of our API and allow you to enrich and customize your requests. This flexibility is what distinguishes us from our competitors.

    You can learn more about what includes are and how they work here:

    hashtag
    Example response

    circle-info

    Check this endpoint in Postman.

    GET All Seasons

    hashtag
    GET All Seasons

    Endpoint details

    Authorization

    API Key

    hashtag
    Parameters

    hashtag
    Include options

    league stages rounds upcoming results groups goalscorers cardscorers assistscorers aggregatedGoalscorers aggregatedCardscorers aggregatedAssistscorers fixtures

    Includes are the cornerstone of our API and allow you to enrich and customize your requests. This flexibility is what distinguishes us from our competitors.

    You can learn more about what includes are and how they work here:

    hashtag
    Example response

    circle-info

    Check this endpoint in Postman.

    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.

    hashtag
    GET Search Team by Name

    Endpoint details

    Authorization

    hashtag
    Parameters

    hashtag
    Include options

    country squad coach transfers sidelined stats venue fifaranking uefaranking visitorFixtures localFixtures visitorResults latest

    circle-info

    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:

    hashtag
    Example response

    circle-info

    Check this endpoint in Postman.

    GET Team Squad by Team and Season ID

    hashtag
    GET Team Squad by Team and Season ID

    Endpoint details

    Authorization

    API Key

    hashtag
    Parameters

    hashtag
    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:

    hashtag
    Example response

    circle-info

    Check this endpoint in Postman.

    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.

    hashtag
    GET Standings Corrections by Season ID

    Endpoint details

    Authorization

    hashtag
    Parameters

    No parameters available for this endpoint.

    hashtag
    Include options

    No includes available for this endpoint.

    hashtag
    Example response

    circle-info

    Check this endpoint in Postman.

    Search Player by Name

    hashtag
    GET Search Player by Name

    GET Teams by Country ID

    hashtag
    GET Teams by Country ID

    GET Venues by Season ID

    hashtag
    GET Venue by ID

    GET All Fixtures by Market ID

    hashtag
    GET All Fixtures by Market ID

    GET Probabilities

    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.

    GET Value Bets

    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.

    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.

    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 .

    GET Leagues and Performances

    hashtag
    GET Leagues and Performances

    https://soccer.sportmonks.com/api/v2.0/odds/inplay/fixture/{fixture_ID}
    https://soccer.sportmonks.com/api/v2.0/odds/fixture/{fixture_ID}
    https://soccer.sportmonks.com/api/v2.0/teams/939?api_token={API_TOKEN}
    "data": {
            "id": 939,
            "legacy_id": 513,
            "name": "Midtjylland",
            "short_code": "FCM",
            "twitter": null,
            "country_id": 320,
            "national_team": false,
            "founded": 1999,
            "logo_path": "https://cdn.sportmonks.com/images//soccer/teams/11/939.png",
            "venue_id": 342,
            "current_season_id": 18334,
            "is_placeholder": false
        },
    https://soccer.sportmonks.com/api/v2.0/teams/{ID}
    https://soccer.sportmonks.com/api/v2.0/countries/{ID}/leagues
    https://soccer.sportmonks.com/api/v2.0/rounds/season/{ID}
    https://soccer.sportmonks.com/api/v2.0/seasons
    https://soccer.sportmonks.com/api/v2.0/teams/search/{team_name}
    https://soccer.sportmonks.com/api/v2.0/squad/season/{season_ID}/team/{team_ID}
    https://soccer.sportmonks.com/api/v2.0/corrections/season/{season_ID}
    Run in Postman
    Run in Postman
    Run in Postman
    Run in Postman
    Run in Postman
    Run in Postman
    Run in Postman
    Run in Postman
    Run in Postman
    Run in Postman
    Run in Postman

    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

    Pagination

    NO

    Allowed nested includes

    2

    Available parameters

    include

    Enrich the API with more data and/or nested includes. Can be used by adding &include= etc. to your request url.

    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

    https://soccer.sportmonks.com/api/v2.0/countries/462/leagues?api_token={API_TOKEN}
    Includeschevron-right
    arrow-up-right
        "data": [
            {
                "id": 8,
                "active": true,
                "type": "domestic",
                "legacy_id": 29,
                "country_id": 462,
                "logo_path": "https://cdn.sportmonks.com/images/soccer/leagues/8/8.png",
                "name": "Premier League",
                "is_cup": false,
                "is_friendly": false,
                "current_season_id": 18378,
                "current_round_id": null,
                "current_stage_id": 77453700,
                "live_standings": true,
                "coverage": {
                    "predictions": true,
                    "topscorer_goals": true,
                    "topscorer_assists": true,
                    "topscorer_cards": true
                }
            },
            {
                "id": 9,
                "active": true,
                "type": "domestic",
                "legacy_id": 30,
                "country_id": 462,
                "logo_path": "https://cdn.sportmonks.com/images/soccer/leagues/9/9.png",
                "name": "Championship",
                "is_cup": false,
                "is_friendly": false,
                "current_season_id": 18432,
                "current_round_id": null,
                "current_stage_id": null,
                "live_standings": true,
                "coverage": {
                    "predictions": true,
                    "topscorer_goals": true,
                    "topscorer_assists": true,
                    "topscorer_cards": true
                }
            },
            {
                "id": 12,
                "active": true,
                "type": "domestic",
                "legacy_id": 34,
                "country_id": 462,
                "logo_path": "https://cdn.sportmonks.com/images/soccer/leagues/12/12.png",
                "name": "League One",
                "is_cup": false,
                "is_friendly": false,
                "current_season_id": 18433,
                "current_round_id": null,
                "current_stage_id": null,
                "live_standings": true,
                "coverage": {
                    "predictions": true,
                    "topscorer_goals": true,
                    "topscorer_assists": true,
                    "topscorer_cards": true
                }
            },
            {
                "id": 14,
                "active": true,
                "type": "domestic",
                "legacy_id": 32,
                "country_id": 462,
                "logo_path": "https://cdn.sportmonks.com/images/soccer/leagues/14/14.png",
                "name": "League Two",
                "is_cup": false,
                "is_friendly": false,
                "current_season_id": 18434,
                "current_round_id": null,
                "current_stage_id": null,
                "live_standings": true,
                "coverage": {
                    "predictions": true,
                    "topscorer_goals": true,
                    "topscorer_assists": true,
                    "topscorer_cards": true
                }
            },

    Indicates what kind of league this is. Possible values: 'domestic', 'cup', 'international'. More values can be found

    stage_id

    The unique stage id the round belongs to

    start

    The start date of the round

    end

    The end date of the round

    Pagination

    NO

    Allowed nested includes

    2

    Available parameters

    include

    Enrich the API with more data and/or nested includes. Can be used by adding &include= to your request url.

    Field

    Description

    id

    The unique id of the round

    name

    The name of the round

    league_id

    The unique league id the round belongs to

    season_id

    https://soccer.sportmonks.com/api/v2.0/rounds/season/17141?api_token={API_TOKEN}
    Includeschevron-right
    arrow-up-right
       "data": [
            {
                "id": 194968,
                "name": 1,
                "league_id": 501,
                "season_id": 17141,
                "stage_id": 77447501,
                "start": "2020-08-01",
                "end": "2020-08-03"
            },
            {
                "id": 194969,
                "name": 2,
                "league_id": 501,
                "season_id": 17141,
                "stage_id": 77447501,
                "start": "2020-08-08",
                "end": "2020-08-09"
            },
            {
                "id": 194970,
                "name": 3,
                "league_id": 501,
                "season_id": 17141,
                "stage_id": 77447501,
                "start": "2020-08-11",
                "end": "2020-08-12"
            },
            {
                "id": 194971,
                "name": 4,
                "league_id": 501,
                "season_id": 17141,
                "stage_id": 77447501,
                "start": "2020-08-15",
                "end": "2020-08-16"
            },
            {
                "id": 194972,
                "name": 5,
                "league_id": 501,
                "season_id": 17141,
                "stage_id": 77447501,
                "start": "2020-08-22",
                "end": "2020-08-23"
            },
            {
                "id": 194973,
                "name": 6,
                "league_id": 501,
                "season_id": 17141,
                "stage_id": 77447501,
                "start": "2020-08-29",
                "end": "2020-08-30"
            },
            {
                "id": 194974,
                "name": 7,
                "league_id": 501,
                "season_id": 17141,
                "stage_id": 77447501,
                "start": "2020-09-12",
                "end": "2020-09-12"
            },
            {
                "id": 194975,
                "name": 8,
                "league_id": 501,
                "season_id": 17141,
                "stage_id": 77447501,
                "start": "2020-09-19",
                "end": "2020-09-20"
            },
            {
                "id": 194976,
                "name": 9,
                "league_id": 501,
                "season_id": 17141,
                "stage_id": 77447501,
                "start": "2020-09-26",
                "end": "2020-09-27"
            },
            {
                "id": 194977,
                "name": 10,
                "league_id": 501,
                "season_id": 17141,
                "stage_id": 77447501,
                "start": "2020-10-02",
                "end": "2020-10-04"
            },

    The unique season id the round belongs to

    is_current_season

    Indicates if the season is the current one. Possible values are "true" or "false"

    current_round_id

    The unique id of the current round

    current_stage_id

    The unique id of the current stage

    Pagination

    YES

    Allowed nested includes

    4

    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.

    Field

    Description

    data

    Opens an array of data you've requested

    id

    The unique season id

    name

    The name of the season

    league_id

    https://soccer.sportmonks.com/api/v2.0/seasons?api_token={API_TOKEN}
    Includeschevron-right
    arrow-up-right
     "data": [
            {
                "id": 5307,
                "name": "2005/2006",
                "league_id": 2,
                "is_current_season": false,
                "current_round_id": null,
                "current_stage_id": null
            },
            {
                "id": 5308,
                "name": "2006/2007",
                "league_id": 2,
                "is_current_season": false,
                "current_round_id": null,
                "current_stage_id": null
            },
            {
                "id": 5309,
                "name": "2007/2008",
                "league_id": 2,
                "is_current_season": false,
                "current_round_id": null,
                "current_stage_id": null
            },
            {
                "id": 5310,
                "name": "2008/2009",
                "league_id": 2,
                "is_current_season": false,
                "current_round_id": null,
                "current_stage_id": null
            },
            {
                "id": 5311,
                "name": "2009/2010",
                "league_id": 2,
                "is_current_season": false,
                "current_round_id": null,
                "current_stage_id": null
            },
            {
                "id": 5312,
                "name": "2010/2011",
                "league_id": 2,
                "is_current_season": false,
                "current_round_id": null,
                "current_stage_id": null
            },
            {
                "id": 5313,
                "name": "2011/2012",
                "league_id": 2,
                "is_current_season": false,
                "current_round_id": null,
                "current_stage_id": null
            },
            {
                "id": 5318,
                "name": "2012/2013",
                "league_id": 2,
                "is_current_season": false,
                "current_round_id": null,
                "current_stage_id": null
            },
            {
                "id": 5315,
                "name": "2013/2014",
                "league_id": 2,
                "is_current_season": false,
                "current_round_id": null,
                "current_stage_id": null
            },
            {
                "id": 5322,
                "name": "2014/2015",
                "league_id": 2,
                "is_current_season": false,
                "current_round_id": null,
                "current_stage_id": null
            },
            {
                "id": 5321,
                "name": "2015/2016",
                "league_id": 2,
                "is_current_season": false,
                "current_round_id": null,
                "current_stage_id": null
            },
            {
                "id": 718,
                "name": "2016/2017",
                "league_id": 2,
                "is_current_season": false,
                "current_round_id": null,
                "current_stage_id": null
            },

    The unique league id the season belongs to

    upcoming
    goalscorers
    cardscorers
    assistscorers
    aggregatedGoalscorers
    aggregatedCardscorers
    aggregatedAssistscorers
    league
    activeSeasons
    trophies
    rivals

    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.

    API Key

    Pagination

    NO

    Allowed nested includes

    2

    Available parameters

    include

    Enrich the API with more data and/or nested includes. Can be used by adding &include= etc. to your request url.

    seasons

    Filter stats, topscorers (if included) based on a comma separated list of season ids. Can be used by adding &seasons= etc. to your request url.

    Field

    Description

    id

    The unique id of the team

    legacy_id

    This was for our API version 1.0. It's only of use for old users of our API

    name

    The name of the team

    short_code

    Includeschevron-right
    arrow-up-right

    The short code of the team

    "
    :
    1
    ,
    "name": "3Way Result",
    "bookmaker": {
    "data": [
    {
    "id": 2,
    "name": "bet365",
    "odds": {
    "data": [
    {
    "order": "0",
    "label": "Midtjylland",
    "info": "Midtjylland",
    "value": "1.01",
    "american": -10000,
    "fractional": "1/100",
    "suspend": false,
    "description": "",
    "handicap": "",
    "last_update": {
    "date": "2019-07-12 19:03:28.000000",
    "timezone_type": 3,
    "timezone": "UTC"
    }
    },
    {
    "order": "1",
    "label": "Draw",
    "info": "Draw",
    "value": "26.00",
    "american": 2500,
    "fractional": "25/1",
    "suspend": false,
    "description": "",
    "handicap": "",
    "last_update": {
    "date": "2019-07-12 19:03:28.000000",
    "timezone_type": 3,
    "timezone": "UTC"
    }
    },
    {
    "order": "2",
    "label": "Esbjerg",
    "info": "Esbjerg",
    "value": "501.00",
    "american": 50000,
    "fractional": "500/1",
    "suspend": false,
    "description": "",
    "handicap": "",
    "last_update": {
    "date": "2019-07-12 19:03:28.000000",
    "timezone_type": 3,
    "timezone": "UTC"
    }
    }
    ]
    }
    }
    ]
    }
    },
    {
    "id": 28,
    "name": "Asian Handicap",
    "bookmaker": {
    "data": [
    {
    "id": 2,
    "name": "bet365",
    "odds": {
    "data": [
    {
    "order": "0",
    "label": "Midtjylland 0.0",
    "info": "Midtjylland 0.0",
    "value": "1.68",
    "american": -148,
    "fractional": "27/40",
    "suspend": false,
    "description": "(1-0) Midtjylland",
    "handicap": "0",
    "last_update": {
    "date": "2019-07-12 19:00:00.000000",
    "timezone_type": 3,
    "timezone": "UTC"
    }
    },
    {
    "order": "1",
    "label": "Esbjerg 0.0",
    "info": "Esbjerg 0.0",
    "value": "2.25",
    "american": 125,
    "fractional": "5/4",
    "suspend": false,
    "description": "(1-0) Esbjerg",
    "handicap": "0",
    "last_update": {
    "date": "2019-07-12 19:00:00.000000",
    "timezone_type": 3,
    "timezone": "UTC"
    }
    }
    ]
    }
    }
    ]
    }
    },
    "
    :
    1
    ,
    "name": "3Way Result",
    "suspended": false,
    "bookmaker": {
    "data": [
    {
    "id": 2,
    "name": "bet365",
    "odds": {
    "data": [
    {
    "label": "1",
    "value": "1.05",
    "probability": "95.24%",
    "dp3": "1.050",
    "american": -2000,
    "factional": null,
    "winning": true,
    "handicap": null,
    "total": null,
    "bookmaker_event_id": null,
    "last_update": {
    "date": "2020-08-02 13:56:17.000000",
    "timezone_type": 3,
    "timezone": "UTC"
    }
    },
    {
    "label": "X",
    "value": "13.00",
    "probability": "7.69%",
    "dp3": "13.000",
    "american": 1200,
    "factional": null,
    "winning": false,
    "handicap": null,
    "total": null,
    "bookmaker_event_id": null,
    "last_update": {
    "date": "2020-08-02 13:56:17.000000",
    "timezone_type": 3,
    "timezone": "UTC"
    }
    },
    {
    "label": "2",
    "value": "23.00",
    "probability": "4.35%",
    "dp3": "23.000",
    "american": 2200,
    "factional": null,
    "winning": false,
    "handicap": null,
    "total": null,
    "bookmaker_event_id": null,
    "last_update": {
    "date": "2020-08-02 13:56:17.000000",
    "timezone_type": 3,
    "timezone": "UTC"
    }
    }
    ]
    }
    },
    {
    "id": 27802,
    "name": "Ladbrokes",
    "odds": {
    "data": [
    {
    "label": "1",
    "value": "1.06",
    "probability": "94.34%",
    "dp3": "1.060",
    "american": -1667,
    "factional": null,
    "winning": true,
    "handicap": null,
    "total": null,
    "bookmaker_event_id": null,
    "last_update": {
    "date": "2020-08-02 14:57:51.000000",
    "timezone_type": 3,
    "timezone": "UTC"
    }
    },
    {
    "label": "X",
    "value": "13.00",
    "probability": "7.69%",
    "dp3": "13.000",
    "american": 1200,
    "factional": null,
    "winning": false,
    "handicap": null,
    "total": null,
    "bookmaker_event_id": null,
    "last_update": {
    "date": "2020-08-02 14:57:51.000000",
    "timezone_type": 3,
    "timezone": "UTC"
    }
    },
    {
    "label": "2",
    "value": "41.00",
    "probability": "2.44%",
    "dp3": "41.000",
    "american": 4000,
    "factional": null,
    "winning": false,
    "handicap": null,
    "total": null,
    "bookmaker_event_id": null,
    "last_update": {
    "date": "2020-08-02 14:57:51.000000",
    "timezone_type": 3,
    "timezone": "UTC"
    }
    }
    ]
    }
    },

    NO

    Allowed nested includes

    2

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

    hashtag
    Include options

    position team stats trophies sidelined transfers lineups country

    Includes are the cornerstone of our API and allow you to enrich and customize your requests. This flexibility is what distinguishes us from our competitors.

    You can learn more about what includes are and how they work here:

    hashtag
    Example response

    https://soccer.sportmonks.com/api/v2.0/players/search/James Forrest?api_token={API_TOKEN}
     "data": [
            {
                "player_id
    

    Field

    Description

    player_id

    The unique id of the main player

    team_id

    The unique id of the team the player belongs to

    country_id

    The unique id of the country the player is from

    position_id

    circle-info

    Check this endpoint in Postman. arrow-up-right

    Endpoint details

    Authorization

    API Key

    Pagination

    Includeschevron-right

    NO

    Allowed nested includes

    3

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

    hashtag
    Include options

    country squad coach transfers sidelined stats venue fifaranking uefaranking visitorFixtures localFixtures visitorResults latest upcoming goalscorers cardscorers assistscorers aggregatedGoalscorers aggregatedCardscorers aggregatedAssistscorers league activeSeasons trophies rivals

    circle-info

    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:

    hashtag
    Example response

    Field

    Description

    id

    The unique id of the team

    legacy_id

    This was for our API version 1.0. It's only of use for old users of our API

    name

    The name of the team

    short_code

    circle-info

    Check this endpoint in Postman. arrow-up-right

    Endpoint details

    Authorization

    API Key

    Pagination

    Includeschevron-right

    NO

    Allowed nested includes

    0

    hashtag
    Parameters

    No parameters available for this endpoint.

    hashtag
    Include options

    No includes available for this endpoint.

    hashtag
    Example response

    https://soccer.sportmonks.com/api/v2.0/venues/season/17141?api_token={API_TOKEN}
    "data": [
            {
                "id"
    
    circle-info

    Check this endpoint in Postman. arrow-up-right

    Endpoint details

    Authorization

    API Key

    Pagination

    NO

    Allowed nested includes

    0

    hashtag
    Parameters

    No parameters available for this endpoint.

    hashtag
    Include options

    No includes available for this endpoint.

    hashtag
    Example response

    https://soccer.sportmonks.com/api/v2.0/markets/1/fixtures?api_token={API_TOKEN}
          "data": [
            {
                "id
    
    circle-info

    Check this endpoint in Postman. arrow-up-right

    Endpoint details

    Authorization

    API Key

    Pagination

    hashtag
    GET Probabilities

    Endpoint details

    Authorization

    API Key

    Pagination

    NO

    Allowed nested includes

    0

    hashtag
    Parameters

    No parameters available for this endpoint.

    hashtag
    Include options

    No includes available for this endpoint.

    hashtag
    Example response

    https://soccer.sportmonks.com/api/v2.0/probabilities/next?api_token={API_TOKEN}
     "data": [
            {
                "fixture_id
    
    circle-info

    Check this endpoint in Postman. arrow-up-right

    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.

    hashtag
    Get Value Bets

    Endpoint details

    Authorization

    API Key

    Pagination

    NO

    Allowed nested includes

    0

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

    hashtag
    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:

    hashtag
    Example response

    circle-info

    Check this endpoint in Postman. arrow-up-right

    Prediction APIarrow-up-right
    Value Bet By Fixture Idarrow-up-right
    Includeschevron-right

    NO

    Allowed nested includes

    0

    hashtag
    Parameters

    No parameters available for this endpoint.

    hashtag
    Include options

    No includes available for this endpoint.

    hashtag
    Example response

    https://soccer.sportmonks.com/api/v2.0/predictions/leagues?api_token={API_TOKEN}
      "data": [
            {
                "id
    
    circle-info

    Check this endpoint in Postman. arrow-up-right

    Endpoint details

    Authorization

    API Key

    Pagination

    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.

    Pagination

    NO

    Allowed nested includes

    3

    Available parameters

    include

    Enrich the API with more data and/or nested includes. Can be used by adding &include= etc to your request url.

    https://soccer.sportmonks.com/api/v2.0/squad/season/17141/team/53?api_token={API_TOKEN}
    Includeschevron-right
    arrow-up-right
        "data": [
            {
                "player_id": 172923,
                "position_id": 1,
                "number": 6,
                "captain": 0,
                "injured": false,
                "minutes": 1620,
                "appearences": 18,
                "lineups": 18,
                "substitute_in": null,
                "substitute_out": null,
                "substitutes_on_bench": 11,
                "goals": null,
                "owngoals": null,
                "assists": null,
                "saves": 39,
                "inside_box_saves": 21,
                "dispossesed": null,
                "interceptions": null,
                "yellowcards": null,
                "yellowred": null,
                "redcards": null,
                "tackles": null,
                "blocks": null,
                "hit_post": null,
                "cleansheets": 7,
                "rating": "6.81",
                "fouls": {
                    "committed": null,
                    "drawn": 3
                },
                "crosses": {
                    "total": null,
                    "accurate": null
                },
                "dribbles": {
                    "attempts": null,
                    "success": null,
                    "dribbled_past": null
                },
                "duels": {
                    "total": 7,
                    "won": 7
                },
                "passes": {
                    "total": 455,
                    "accuracy": 75,
                    "key_passes": null
                },
                "penalties": {
                    "won": null,
                    "scores": null,
                    "missed": null,
                    "committed": null,
                    "saves": 1
                },
                "shots": {
                    "shots_total": null,
                    "shots_on_target": null,
                    "shots_off_target": null
                }
            },
            {
                "player_id": 173999,
                "position_id": 1,
                "number": 65,
                "captain": 0,
                "injured": false,
                "minutes": 450,
                "appearences": 5,
                "lineups": 5,
                "substitute_in": null,
                "substitute_out": null,
                "substitutes_on_bench": 8,
                "goals": null,
                "owngoals": null,
                "assists": null,
                "saves": 10,
                "inside_box_saves": 7,
                "dispossesed": null,
                "interceptions": null,
                "yellowcards": null,
                "yellowred": null,
                "redcards": null,
                "tackles": null,
                "blocks": null,
                "hit_post": null,
                "cleansheets": 4,
                "rating": "7.20",
                "fouls": {
                    "committed": null,
                    "drawn": null
                },
                "crosses": {
                    "total": null,
                    "accurate": null
                },
                "dribbles": {
                    "attempts": null,
                    "success": null,
                    "dribbled_past": null
                },
                "duels": {
                    "total": 1,
                    "won": 1
                },
                "passes": {
                    "total": 91,
                    "accuracy": 74,
                    "key_passes": null
                },
                "penalties": {
                    "won": null,
                    "scores": null,
                    "missed": null,
                    "committed": null,
                    "saves": null
                },
                "shots": {
                    "shots_total": null,
                    "shots_on_target": null,
                    "shots_off_target": null
                }
            },

    API Key

    Pagination

    NO

    Allowed nested includes

    0

    https://soccer.sportmonks.com/api/v2.0/corrections/season/18355?api_token={API_TOKEN}
    arrow-up-right
       "data": [
            {
                "id": 77453655,
                "name": "Regular Season",
                "league_id": 2312,
                "season_id": 18355,
                "round_id": 246881,
                "round_name": 8,
                "type": "Group Stage",
                "stage_id": 77453655,
                "stage_name": "Regular Season",
                "resource": "stage",
                "corrections": {
                    "data": [
                        {
                            "team_id": 255723,
                            "stage_id": 77453655,
                            "points": 3,
                            "type": "-",
                            "updated_at": "2021-08-05T14:00:54.000000Z",
                            "team": {
                                "data": {
                                    "id": 255723,
                                    "legacy_id": null,
                                    "name": "Chicago City W",
                                    "short_code": null,
                                    "twitter": null,
                                    "country_id": 3483,
                                    "national_team": false,
                                    "founded": null,
                                    "logo_path": "https://cdn.sportmonks.com/images/soccer/team_placeholder.png",
                                    "venue_id": null,
                                    "current_season_id": 18355,
                                    "is_placeholder": false
                                }
                            }
                        },
                        {
                            "team_id": 255804,
                            "stage_id": 77453655,
                            "points": 3,
                            "type": "-",
                            "updated_at": "2021-08-05T14:00:54.000000Z",
                            "team": {
                                "data": {
                                    "id": 255804,
                                    "legacy_id": null,
                                    "name": "Dayton Dutch Lions W",
                                    "short_code": null,
                                    "twitter": null,
                                    "country_id": 3483,
                                    "national_team": false,
                                    "founded": null,
                                    "logo_path": "https://cdn.sportmonks.com/images/soccer/team_placeholder.png",
                                    "venue_id": null,
                                    "current_season_id": 18355,
                                    "is_placeholder": false
                                }
                            }
                        },
                        {
                            "team_id": 255737,
                            "stage_id": 77453655,
                            "points": 7,
                            "type": "-",
                            "updated_at": "2021-08-05T14:00:54.000000Z",
                            "team": {
                                "data": {
                                    "id": 255737,
                                    "legacy_id": null,
                                    "name": "New York Athletic W",
                                    "short_code": null,
                                    "twitter": null,
                                    "country_id": 3483,
                                    "national_team": false,
                                    "founded": null,
                                    "logo_path": "https://cdn.sportmonks.com/images/soccer/team_placeholder.png",
                                    "venue_id": null,
                                    "current_season_id": 18355,
                                    "is_placeholder": false
                                }
                            }
                        },
                        {
                            "team_id": 255719,
                            "stage_id": 77453655,
                            "points": 4,
                            "type": "-",
                            "updated_at": "2021-08-05T14:00:54.000000Z",
                            "team": {
                                "data": {
                                    "id": 255719,
                                    "legacy_id": null,
                                    "name": "Soccer House Academy W",
                                    "short_code": null,
                                    "twitter": null,
                                    "country_id": 3483,
                                    "national_team": false,
                                    "founded": null,
                                    "logo_path": "https://cdn.sportmonks.com/images/soccer/team_placeholder.png",
                                    "venue_id": null,
                                    "current_season_id": 18355,
                                    "is_placeholder": false
                                }
                            }
                        },

    GET Current Leagues by Team ID

    hashtag
    GET Current Leagues by Team ID

    Endpoint details

    Authorization

    API Key

    hashtag
    Parameters

    hashtag
    Include options

    No includes available for this endpoint.

    hashtag
    Example response

    circle-info

    Check this endpoint in Postman.

    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.

    hashtag
    Search League by Name

    Endpoint details

    hashtag
    Parameters

    hashtag
    Include options

    country season seasons

    Includes are the cornerstone of our API and allow you to enrich and customize your requests. This flexibility is what distinguishes us from our competitors.

    You can learn more about what includes are and how they work here:

    hashtag
    Example response

    circle-info

    Check this endpoint in Postman.

    GET Players by Country ID

    hashtag
    GET Players by Country ID

    Endpoint details

    Authorization

    API Key

    hashtag
    Parameters

    hashtag
    Include options

    position team stats trophies sidelined transfers lineups country

    Includes are the cornerstone of our API and allow you to enrich and customize your requests. This flexibility is what distinguishes us from our competitors.

    You can learn more about what includes are and how they work here:

    hashtag
    Example response

    circle-info

    Check this endpoint in Postman.

    Get All Leagues by Team ID

    Returns all the leagues/seasons a team ever participated in. This only relates to data that is covered by our API.

    hashtag
    GET All Leagues by Team ID

    Endpoint details

    Authorization

    hashtag
    Parameters

    No parameters available for this endpoint.

    hashtag
    Include options

    No includes available for this endpoint.

    hashtag
    Example response

    circle-info

    Check this endpoint in Postman.

    GET Teams by Season ID

    hashtag
    GET Team by Season ID

    Endpoint details

    Authorization

    API Key

    hashtag
    Parameters

    hashtag
    Include options

    country squad coach transfers sidelined stats venue fifaranking uefaranking visitorFixtures localFixtures visitorResults latest

    circle-info

    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:

    hashtag
    Example response

    circle-info

    Check this endpoint in Postman.

    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

    hashtag
    GET LIVE Standings

    Endpoint details

    Authorization

    hashtag
    Parameters

    triangle-exclamation

    Note for cups the group_id parameter is required.

    hashtag
    Include options

    No includes available for this endpoint.

    hashtag
    Example response

    circle-info

    Check this endpoint in Postman.

    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.

    hashtag
    GET Standings by Season ID and Round ID

    Endpoint details

    Authorization

    hashtag
    Parameters

    No parameters available for this endpoint.

    hashtag
    Include options

    No includes available for this endpoint.

    hashtag
    Example response

    circle-info

    Check this endpoint in Postman.

    GET All Continents

    hashtag
    GET All Continents

    Endpoint details

    Authorization

    API Key

    hashtag
    Parameters

    hashtag
    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:

    hashtag
    Example response

    circle-info

    Check this endpoint in Postman.

    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.

    hashtag
    GET Standings by Season ID and Date(time)

    GET All Leagues

    hashtag
    GET All Leagues

    https://soccer.sportmonks.com/api/v2.0/teams/search/manchester?api_token={API_TOKEN}
     "data": [
            {
                "id": 9,
                "legacy_id": 127,
                "name": "Manchester City",
                "short_code": "MCI",
                "twitter": "@ManCity",
                "country_id": 462,
                "national_team": false,
                "founded": 1880,
                "logo_path": "https://cdn.sportmonks.com/images//soccer/teams/9/9.png",
                "venue_id": 151,
                "current_season_id": 18378,
                "is_placeholder": false
            },
            {
                "id": 14,
                "legacy_id": 375,
                "name": "Manchester United",
                "short_code": "MUN",
                "twitter": "@ManUtd",
                "country_id": 462,
                "national_team": false,
                "founded": 1878,
                "logo_path": "https://cdn.sportmonks.com/images//soccer/teams/14/14.png",
                "venue_id": 206,
                "current_season_id": 18378,
                "is_placeholder": false
            },
            {
                "id": 278,
                "legacy_id": 2533,
                "name": "United of Manchester",
                "short_code": null,
                "twitter": null,
                "country_id": 462,
                "national_team": false,
                "founded": 2005,
                "logo_path": "https://cdn.sportmonks.com/images//soccer/teams/22/278.png",
                "venue_id": 1125,
                "current_season_id": 18600,
                "is_placeholder": false
            },
            {
                "id": 654,
                "legacy_id": 8666,
                "name": "Manchester City U23",
                "short_code": null,
                "twitter": null,
                "country_id": 462,
                "national_team": false,
                "founded": 0,
                "logo_path": "https://cdn.sportmonks.com/images//soccer/teams/14/654.png",
                "venue_id": 12,
                "current_season_id": 18713,
                "is_placeholder": false
            },
            {
                "id": 666,
                "legacy_id": 8806,
                "name": "Manchester United U23",
                "short_code": null,
                "twitter": null,
                "country_id": 462,
                "national_team": false,
                "founded": null,
                "logo_path": "https://cdn.sportmonks.com/images//soccer/teams/26/666.png",
                "venue_id": 1208,
                "current_season_id": 18713,
                "is_placeholder": false
            },
    https://soccer.sportmonks.com/api/v2.0/players/search/{player_name}
    https://soccer.sportmonks.com/api/v2.0/countries/320/teams?api_token={API_TOKEN}
    "data": [
            {
                "id": 85,
                "legacy_id": 146,
                "name": "København",
                "short_code": "COP",
                "twitter": null,
                "country_id": 320,
                "national_team": false,
                "founded": 1992,
                "logo_path": "https://cdn.sportmonks.com/images//soccer/teams/21/85.png",
                "venue_id": 5655,
                "current_season_id": 18334,
                "is_placeholder": false
            },
            {
                "id": 86,
                "legacy_id": 522,
                "name": "Silkeborg",
                "short_code": "SIL",
                "twitter": null,
                "country_id": 320,
                "national_team": false,
                "founded": 1917,
                "logo_path": "https://cdn.sportmonks.com/images//soccer/teams/22/86.png",
                "venue_id": 85371,
                "current_season_id": 18334,
                "is_placeholder": false
            },
            {
                "id": 211,
                "legacy_id": 631,
                "name": "Horsens",
                "short_code": "ACH",
                "twitter": null,
                "country_id": 320,
                "national_team": false,
                "founded": 1994,
                "logo_path": "https://cdn.sportmonks.com/images//soccer/teams/19/211.png",
                "venue_id": 5661,
                "current_season_id": 18342,
                "is_placeholder": false
            },
            {
                "id": 293,
                "legacy_id": null,
                "name": "Brøndby",
                "short_code": "SLO",
                "twitter": null,
                "country_id": 320,
                "national_team": false,
                "founded": 1964,
                "logo_path": "https://cdn.sportmonks.com/images//soccer/teams/5/293.png",
                "venue_id": 5659,
                "current_season_id": 18334,
                "is_placeholder": false
            },
            {
                "id": 390,
                "legacy_id": null,
                "name": "SønderjyskE",
                "short_code": "SON",
                "twitter": null,
                "country_id": 320,
                "national_team": false,
                "founded": 2004,
                "logo_path": "https://cdn.sportmonks.com/images//soccer/teams/6/390.png",
                "venue_id": 5653,
                "current_season_id": 18334,
                "is_placeholder": false
            },
            {
                "id": 939,
                "legacy_id": 513,
                "name": "Midtjylland",
                "short_code": "FCM",
                "twitter": null,
                "country_id": 320,
                "national_team": false,
                "founded": 1999,
                "logo_path": "https://cdn.sportmonks.com/images//soccer/teams/11/939.png",
                "venue_id": 342,
                "current_season_id": 18334,
                "is_placeholder": false
            },
    https://soccer.sportmonks.com/api/v2.0/countries/{ID}/teams
    https://soccer.sportmonks.com/api/v2.0/venues/season/{ID}
    https://soccer.sportmonks.com/api/v2.0/markets/{ID}/fixtures
    https://soccer.sportmonks.com/api/v2.0/predictions/probabilities/next
    https://soccer.sportmonks.com/api/v2.0/predictions/valuebets/next?api_token={API_TOKEN}
     "data": [
            {
                "fixture_id": 18304534,
                "predictions": {
                    "bet": "2",
                    "bookmaker": "pncl",
                    "odd": 7.79,
                    "is_value": false,
                    "stake": 0.33,
                    "fair_odd": 7.03
                }
            },
            {
                "fixture_id": 18326452,
                "predictions": {
                    "bet": "X",
                    "bookmaker": "bet365",
                    "odd": 2.8,
                    "is_value": false,
                    "stake": 0.65,
                    "fair_odd": 2.66
                }
            },
            {
                "fixture_id": 18326460,
                "predictions": {
                    "bet": "2",
                    "bookmaker": "1xbet",
                    "odd": 2.71,
                    "is_value": false,
                    "stake": 0.67,
                    "fair_odd": 2.58
                }
            },
            {
                "fixture_id": 18249798,
                "predictions": {
                    "bet": "X",
                    "bookmaker": "bet365",
                    "odd": 3.75,
                    "is_value": true,
                    "stake": 0.52,
                    "fair_odd": 3.51
                }
            },
            {
                "fixture_id": 18101929,
                "predictions": {
                    "bet": "1",
                    "bookmaker": "pncl",
                    "odd": 2.9,
                    "is_value": true,
                    "stake": 0.63,
                    "fair_odd": 2.75
                }
            },
            {
                "fixture_id": 18304463,
                "predictions": {
                    "bet": "1",
                    "bookmaker": "williamhill",
                    "odd": 4,
                    "is_value": false,
                    "stake": 0.49,
                    "fair_odd": 3.73
                }
            },
            {
                "fixture_id": 18044051,
                "predictions": {
                    "bet": "1",
                    "bookmaker": "bet365",
                    "odd": 1.62,
                    "is_value": false,
                    "stake": 1.16,
                    "fair_odd": 1.58
                }
            },
            {
                "fixture_id": 18300186,
                "predictions": {
                    "bet": "1",
                    "bookmaker": "betway",
                    "odd": 1.53,
                    "is_value": false,
                    "stake": 1.27,
                    "fair_odd": 1.5
                }
            },
            {
                "fixture_id": 18304459,
                "predictions": {
                    "bet": "1",
                    "bookmaker": "williamhill",
                    "odd": 6.5,
                    "is_value": true,
                    "stake": 0.38,
                    "fair_odd": 5.92
                }
            },
    https://soccer.sportmonks.com/api/v2.0/predictions/valuebets/next
    https://soccer.sportmonks.com/api/v2.0/predictions/leagues
    https://soccer.sportmonks.com/api/v2.0/teams/{ID}/current
    https://soccer.sportmonks.com/api/v2.0/leagues/search/{league_name}
    https://soccer.sportmonks.com/api/v2.0/countries/{ID}/players
    https://soccer.sportmonks.com/api/v2.0/teams/{ID}/history
    https://soccer.sportmonks.com/api/v2.0/teams/season/{season_ID}
    https://soccer.sportmonks.com/api/v2.0/standings/season/live/{season_ID}
    https://soccer.sportmonks.com/api/v2.0/standings/season/{season_ID}/round/{round_ID}
    https://soccer.sportmonks.com/api/v2.0/continents
    Run in Postman
    Run in Postman
    Run in Postman
    here
    Run in Postman
    Run in Postman
    Run in Postman
    Run in Postman
    Run in Postman
    Run in Postman

    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

    Pagination

    NO

    Allowed nested includes

    0

    Available parameters

    range

    A range of 2 dates separated by a comma. format should be YYYY-MM-DD.

    Field

    Description

    data

    Opens an array of data you've requested

    id

    A unique league id

    active

    https://soccer.sportmonks.com/api/v2.0/teams/939/current?api_token={API_TOKEN}
    arrow-up-right
    "data": [
            {
                "id": 17845,
                "name": "2021",
                "league_id": 1101,
                "is_current_season": true,
                "current_round_id": null,
                "current_stage_id": 77450044,
                "league": {
                    "data": {
                        "id": 1101,
                        "active": true,
                        "type": "domestic",
                        "legacy_id": 108,
                        "country_id": 99474,
                        "logo_path": "https://cdn.sportmonks.com/images//soccer/leagues/13/1101.png",
                        "name": "Club Friendlies",
                        "is_cup": false,
                        "is_friendly": true,
                        "current_season_id": 17845,
                        "current_round_id": null,
                        "current_stage_id": 77450044,
                        "live_standings": false,
                        "coverage": {
                            "predictions": true,
                            "topscorer_goals": true,
                            "topscorer_assists": true,
                            "topscorer_cards": true
                        }
                    }
                }
            },
            {
                "id": 18334,
                "name": "2021/2022",
                "league_id": 271,
                "is_current_season": true,
                "current_round_id": 246626,
                "current_stage_id": 77453568,
                "league": {
                    "data": {
                        "id": 271,
                        "active": true,
                        "type": "domestic",
                        "legacy_id": 43,
                        "country_id": 320,
                        "logo_path": "https://cdn.sportmonks.com/images/soccer/leagues/271.png",
                        "name": "Superliga",
                        "is_cup": false,
                        "is_friendly": false,
                        "current_season_id": 18334,
                        "current_round_id": 246626,
                        "current_stage_id": 77453568,
                        "live_standings": true,
                        "coverage": {
                            "predictions": true,
                            "topscorer_goals": true,
                            "topscorer_assists": true,
                            "topscorer_cards": true
                        }
                    }
                }
            },
            {
                "id": 18346,
                "name": "2021/2022",
                "league_id": 2,
                "is_current_season": true,
                "current_round_id": null,
                "current_stage_id": 77453623,
                "league": {
                    "data": {
                        "id": 2,
                        "active": true,
                        "type": "cup_international",
                        "legacy_id": 11,
                        "country_id": 41,
                        "logo_path": "https://cdn.sportmonks.com/images/soccer/leagues/2.png",
                        "name": "Champions League",
                        "is_cup": true,
                        "is_friendly": false,
                        "current_season_id": 18346,
                        "current_round_id": null,
                        "current_stage_id": 77453623,
                        "live_standings": true,
                        "coverage": {
                            "predictions": false,
                            "topscorer_goals": true,
                            "topscorer_assists": true,
                            "topscorer_cards": true
                        }
                    }
                }
            }
        ],

    Indicates if the league is active or not. Possible values are 'true' or 'false'

    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

    Authorization

    API Key

    Pagination

    NO

    Allowed nested includes

    2

    Available parameters

    include

    Enrich the API with more data and/or nested includes. Can be used by adding &include= etc. to your request url.

    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

    https://soccer.sportmonks.com/api/v2.0/leagues/search/premier?api_token={API_TOKEN}
    Includeschevron-right
    arrow-up-right
    "data": [
            {
                "id": 8,
                "active": true,
                "type": "domestic",
                "legacy_id": 29,
                "country_id": 462,
                "logo_path": "https://cdn.sportmonks.com/images/soccer/leagues/8/8.png",
                "name": "Premier League",
                "is_cup": false,
                "is_friendly": false,
                "current_season_id": 18378,
                "current_round_id": null,
                "current_stage_id": 77453700,
                "live_standings": true,
                "coverage": {
                    "predictions": true,
                    "topscorer_goals": true,
                    "topscorer_assists": true,
                    "topscorer_cards": true
                }
            },
            {
                "id": 32,
                "active": true,
                "type": "domestic_cup",
                "legacy_id": 474,
                "country_id": 462,
                "logo_path": "https://cdn.sportmonks.com/images/soccer/leagues/0/32.png",
                "name": "Premier League Cup",
                "is_cup": true,
                "is_friendly": false,
                "current_season_id": 16589,
                "current_round_id": null,
                "current_stage_id": null,
                "live_standings": false,
                "coverage": {
                    "predictions": false,
                    "topscorer_goals": true,
                    "topscorer_assists": true,
                    "topscorer_cards": true
                }
            },
            {
                "id": 35,
                "active": true,
                "type": "domestic",
                "legacy_id": 290,
                "country_id": 462,
                "logo_path": "https://cdn.sportmonks.com/images/soccer/leagues/3/35.png",
                "name": "Premier League U21",
                "is_cup": false,
                "is_friendly": false,
                "current_season_id": null,
                "current_round_id": null,
                "current_stage_id": null,
                "live_standings": false,
                "coverage": {
                    "predictions": false,
                    "topscorer_goals": true,
                    "topscorer_assists": true,
                    "topscorer_cards": true
                }
            },
            {
                "id": 38,
                "active": true,
                "type": "domestic_cup",
                "legacy_id": null,
                "country_id": 462,
                "logo_path": "https://cdn.sportmonks.com/images/soccer/leagues/6/38.png",
                "name": "Premier League International Cup",
                "is_cup": true,
                "is_friendly": false,
                "current_season_id": 16558,
                "current_round_id": null,
                "current_stage_id": null,
                "live_standings": false,
                "coverage": {
                    "predictions": false,
                    "topscorer_goals": true,
                    "topscorer_assists": true,
                    "topscorer_cards": true
                }
            },

    Indicates what kind of league this is. Possible values: 'domestic', 'cup', 'international'. More values can be found

    common_name

    The common name the player is known for

    display_name

    The display name of the player. Often used to show in the lineup formation

    fullname

    The full name of the player

    firstname

    The first name of the player

    lastname

    The last name of the player

    nationality

    The nationality of the player

    birthdate

    The date of birth of the player

    birthcountry

    The country the player was born in

    birthplace

    The place the player was born in

    height

    The height of the player

    weight

    The weight of the player

    image_path

    The URL of the player image

    Pagination

    NO

    Allowed nested includes

    2

    Available parameters

    include

    Enrich the API with more data and/or nested includes. Can be used by adding &include= to your request url.

    Field

    Description

    player_id

    The unique id of the main player

    team_id

    The unique id of the team the player belongs to

    country_id

    The unique id of the country the player is from

    position_id

    https://soccer.sportmonks.com/api/v2.0/countries/320/players?api_token={API_TOKEN}
    Includeschevron-right
    arrow-up-right
    "data": [
            {
                "player_id": 49,
                "team_id": 3,
                "country_id": 320,
                "position_id": 4,
                "common_name": "N. Bendtner",
                "display_name": "Nicklas Bendtner",
                "fullname": "Nicklas Bendtner",
                "firstname": "Nicklas",
                "lastname": "Bendtner",
                "nationality": "Denmark",
                "birthdate": "16/01/1988",
                "birthcountry": "Denmark",
                "birthplace": "København",
                "height": "193 cm",
                "weight": "84 kg",
                "image_path": "https://cdn.sportmonks.com/images/soccer/players/17/49.png"
            },
            {
                "player_id": 169,
                "team_id": 42,
                "country_id": 320,
                "position_id": 1,
                "common_name": "K. Schmeichel",
                "display_name": "Kasper Schmeichel",
                "fullname": "Kasper Schmeichel",
                "firstname": "Kasper",
                "lastname": "Schmeichel",
                "nationality": "Denmark",
                "birthdate": "05/11/1986",
                "birthcountry": "Denmark",
                "birthplace": "København",
                "height": "189 cm",
                "weight": "89 kg",
                "image_path": "https://cdn.sportmonks.com/images/soccer/players/9/169.png"
            },
            {
                "player_id": 269,
                "team_id": 2,
                "country_id": 320,
                "position_id": 2,
                "common_name": "L. Jacobsen",
                "display_name": "Lars Jacobsen",
                "fullname": "Lars Christian Jacobsen",
                "firstname": "Lars Christian",
                "lastname": "Jacobsen",
                "nationality": "Denmark",
                "birthdate": "20/09/1979",
                "birthcountry": "Denmark",
                "birthplace": "Odense",
                "height": "181 cm",
                "weight": "76 kg",
                "image_path": "https://cdn.sportmonks.com/images/soccer/players/13/269.png"
            },
            {
                "player_id": 335,
                "team_id": 11,
                "country_id": 320,
                "position_id": 3,
                "common_name": "L. Andreasen",
                "display_name": "Leon Andreasen",
                "fullname": "Leon Andreasen",
                "firstname": "Leon",
                "lastname": "Andreasen",
                "nationality": "Denmark",
                "birthdate": "23/04/1983",
                "birthcountry": "Denmark",
                "birthplace": "Aarhus",
                "height": "188 cm",
                "weight": "81 kg",
                "image_path": "https://cdn.sportmonks.com/images/soccer/players/15/335.png"
            },
            {
                "player_id": 449,
                "team_id": 26,
                "country_id": 320,
                "position_id": 1,
                "common_name": "T. Løvendahl Sørensen",
                "display_name": "Thomas Sorensen",
                "fullname": "Thomas Løvendahl Sørensen",
                "firstname": "Thomas",
                "lastname": "Løvendahl Sørensen",
                "nationality": "Denmark",
                "birthdate": "12/06/1976",
                "birthcountry": "Denmark",
                "birthplace": "Fredericia",
                "height": "196 cm",
                "weight": "89 kg",
                "image_path": "https://cdn.sportmonks.com/images/soccer/players/1/449.png"
            },

    The unique id of the position the player plays in

    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

    API Key

    Pagination

    NO

    Allowed nested includes

    0

    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

    https://soccer.sportmonks.com/api/v2.0/teams/939/history?api_token={API_TOKEN}
    arrow-up-right
    "data": [
            {
                "id": 719,
                "name": "2016/2017",
                "league_id": 5,
                "is_current_season": false,
                "current_round_id": null,
                "current_stage_id": null,
                "league": {
                    "data": {
                        "id": 5,
                        "active": true,
                        "type": "cup_international",
                        "legacy_id": 12,
                        "country_id": 41,
                        "logo_path": "https://cdn.sportmonks.com/images/soccer/leagues/5.png",
                        "name": "Europa League",
                        "is_cup": true,
                        "is_friendly": false,
                        "current_season_id": 18629,
                        "current_round_id": null,
                        "current_stage_id": 77454501,
                        "live_standings": true,
                        "coverage": {
                            "predictions": false,
                            "topscorer_goals": true,
                            "topscorer_assists": true,
                            "topscorer_cards": true
                        }
                    }
                }
            },
            {
                "id": 746,
                "name": "2016/2017",
                "league_id": 277,
                "is_current_season": false,
                "current_round_id": null,
                "current_stage_id": null,
                "league": {
                    "data": {
                        "id": 277,
                        "active": true,
                        "type": "domestic_cup",
                        "legacy_id": 103,
                        "country_id": 320,
                        "logo_path": "https://cdn.sportmonks.com/images//soccer/leagues/21/277.png",
                        "name": "Landspokal Cup",
                        "is_cup": true,
                        "is_friendly": false,
                        "current_season_id": 18558,
                        "current_round_id": null,
                        "current_stage_id": 77454306,
                        "live_standings": false,
                        "coverage": {
                            "predictions": false,
                            "topscorer_goals": true,
                            "topscorer_assists": true,
                            "topscorer_cards": true
                        }
                    }
                }
            },
            {
                "id": 759,
                "name": "2016/2017",
                "league_id": 271,
                "is_current_season": false,
                "current_round_id": null,
                "current_stage_id": null,
                "league": {
                    "data": {
                        "id": 271,
                        "active": true,
                        "type": "domestic",
                        "legacy_id": 43,
                        "country_id": 320,
                        "logo_path": "https://cdn.sportmonks.com/images/soccer/leagues/271.png",
                        "name": "Superliga",
                        "is_cup": false,
                        "is_friendly": false,
                        "current_season_id": 18334,
                        "current_round_id": 246626,
                        "current_stage_id": 77453568,
                        "live_standings": true,
                        "coverage": {
                            "predictions": true,
                            "topscorer_goals": true,
                            "topscorer_assists": true,
                            "topscorer_cards": true
                        }
                    }
                }
            },

    Indicates what kind of league this is. Possible values: 'domestic', 'cup', 'international'. More values can be found

    upcoming
    country
    squad
    coach
    transfers
    sidelined
    stats
    venue
    fifaranking
    uefaranking
    visitorFixtures
    localFixtures
    visitorResults
    latest
    upcoming
    goalscorers
    cardscorers
    assistscorers
    aggregatedGoalscorers
    aggregatedCardscorers
    aggregatedAssistscorers
    trophies
    rivals

    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.

    Pagination

    YES

    Allowed nested includes

    3

    Available parameters

    include

    Enrich the API with more data and/or nested includes. Can be used by adding &include= etc. to your request url.

    seasons

    Filter stats, topscorers (if included) based on a comma separated list of season ids. Can be used by adding &seasons= etc. to your request url.

    Field

    Description

    id

    The unique id of the team

    legacy_id

    This was for our API version 1.0. It's only of use for old users of our API

    name

    The name of the team

    short_code

    Includeschevron-right
    arrow-up-right

    The short code of the team

    round_name

    The name of the round

    group_id

    The unique id of the group, in which the team participates in

    group_name

    The name of the group, in which the team participates in

    overall

    The overall results of the team, i.e., the number of games, points and goals

    home

    The home results of the team, i.e., the number of games, points and goals

    away

    The away results of the team, i.e., the number of games, points and goals

    total

    The total points of the team and their goal difference

    results

    The standing rules of the place the team is in

    points

    The accumulated number of points the team has

    recent_form

    The recent form of the team

    status

    Will be available in API 3.0: Indicates if the team moves up on down based on the last standings.

    API Key

    Pagination

    NO

    Allowed nested includes

    0

    Available parameters

    group_id

    One id of a group can be added to filter the tables. Can be used by adding &group_id= etc to your request url.

    Field

    Description

    position

    The actual position in the rankings in the stage

    team_id

    The unique team id of the team in that position in the stage

    team_name

    The team name in that position in the stage

    round_id

    https://soccer.sportmonks.com/api/v2.0/standings/season/live/18378?api_token={API_TOKEN}
    arrow-up-right
    "data": [
            {
                "position": 1,
                "played": 0,
                "team_id": 19,
                "team_name": "Arsenal",
                "short_code": "ARS",
                "team_logo": "https://cdn.sportmonks.com/images/soccer/teams/19/19.png",
                "goals": "0:0",
                "goal_diff": 0,
                "wins": 0,
                "lost": 0,
                "draws": 0,
                "points": 0,
                "description": "UEFA Champions League",
                "recent_form": "",
                "fairplay_points_lose": 0
            },
            {
                "position": 2,
                "played": 0,
                "team_id": 15,
                "team_name": "Aston Villa",
                "short_code": "AVA",
                "team_logo": "https://cdn.sportmonks.com/images/soccer/teams/15/15.png",
                "goals": "0:0",
                "goal_diff": 0,
                "wins": 0,
                "lost": 0,
                "draws": 0,
                "points": 0,
                "description": "UEFA Champions League",
                "recent_form": "",
                "fairplay_points_lose": 0
            },
            {
                "position": 3,
                "played": 0,
                "team_id": 236,
                "team_name": "Brentford",
                "short_code": "BRE",
                "team_logo": "https://cdn.sportmonks.com/images/soccer/teams/12/236.png",
                "goals": "0:0",
                "goal_diff": 0,
                "wins": 0,
                "lost": 0,
                "draws": 0,
                "points": 0,
                "description": "UEFA Champions League",
                "recent_form": "",
                "fairplay_points_lose": 0
            },
            {
                "position": 4,
                "played": 0,
                "team_id": 78,
                "team_name": "Brighton & Hove Albion",
                "short_code": "BRH",
                "team_logo": "https://cdn.sportmonks.com/images/soccer/teams/14/78.png",
                "goals": "0:0",
                "goal_diff": 0,
                "wins": 0,
                "lost": 0,
                "draws": 0,
                "points": 0,
                "description": "UEFA Champions League",
                "recent_form": "",
                "fairplay_points_lose": 0
            },
            {
                "position": 5,
                "played": 0,
                "team_id": 27,
                "team_name": "Burnley",
                "short_code": "BUR",
                "team_logo": "https://cdn.sportmonks.com/images/soccer/teams/27/27.png",
                "goals": "0:0",
                "goal_diff": 0,
                "wins": 0,
                "lost": 0,
                "draws": 0,
                "points": 0,
                "description": "UEFA Europa League",
                "recent_form": "",
                "fairplay_points_lose": 0
            },

    The unique id of the current round

    round_name

    The name of the round

    group_id

    The unique id of the group, in which the team participates in

    group_name

    The name of the group, in which the team participates in

    overall

    The overall results of the team, i.e., the number of games, points and goals

    home

    The home results of the team, i.e., the number of games, points and goals

    away

    The away results of the team, i.e., the number of games, points and goals

    total

    The total points of the team and their goal difference

    results

    The standing rules of the place the team is in

    points

    The accumulated number of points the team has

    recent_form

    The recent form of the team

    status

    Will be available in API 3.0: Indicates if the team moves up on down based on the last standings.

    API Key

    Pagination

    NO

    Allowed nested includes

    0

    Field

    Description

    position

    The actual position in the rankings in the stage

    team_id

    The unique team id of the team in that position in the stage

    team_name

    The team name in that position in the stage

    round_id

    https://soccer.sportmonks.com/api/v2.0/standings/season/17141/round/194968?api_token={API_TOKEN}
    arrow-up-right
    "data": [
            {
                "position": 1,
                "team_id": 53,
                "team_name": "Celtic",
                "short_code": "CEL",
                "team_logo": "https://cdn.sportmonks.com/images/soccer/teams/21/53.png",
                "overall": {
                    "games_played": 1,
                    "won": 1,
                    "draw": 0,
                    "lost": 0,
                    "goals_scored": 5,
                    "goals_against": 1,
                    "goal_diff": 4
                },
                "home": {
                    "games_played": 1,
                    "won": 1,
                    "draw": 0,
                    "lost": 0,
                    "goals_scored": 5,
                    "goals_against": 1
                },
                "away": {
                    "games_played": 0,
                    "won": 0,
                    "draw": 0,
                    "lost": 0,
                    "goals_scored": 0,
                    "goals_against": 0
                },
                "points": 3,
                "description": "Championship Round",
                "recent_form": "W"
            },
            {
                "position": 2,
                "team_id": 66,
                "team_name": "Hibernian",
                "short_code": "HIB",
                "team_logo": "https://cdn.sportmonks.com/images/soccer/teams/2/66.png",
                "overall": {
                    "games_played": 1,
                    "won": 1,
                    "draw": 0,
                    "lost": 0,
                    "goals_scored": 2,
                    "goals_against": 1,
                    "goal_diff": 1
                },
                "home": {
                    "games_played": 1,
                    "won": 1,
                    "draw": 0,
                    "lost": 0,
                    "goals_scored": 2,
                    "goals_against": 1
                },
                "away": {
                    "games_played": 0,
                    "won": 0,
                    "draw": 0,
                    "lost": 0,
                    "goals_scored": 0,
                    "goals_against": 0
                },
                "points": 3,
                "description": "Championship Round",
                "recent_form": "W"
            },
            {
                "position": 3,
                "team_id": 62,
                "team_name": "Rangers",
                "short_code": "RAN",
                "team_logo": "https://cdn.sportmonks.com/images/soccer/teams/30/62.png",
                "overall": {
                    "games_played": 1,
                    "won": 1,
                    "draw": 0,
                    "lost": 0,
                    "goals_scored": 1,
                    "goals_against": 0,
                    "goal_diff": 1
                },
                "home": {
                    "games_played": 0,
                    "won": 0,
                    "draw": 0,
                    "lost": 0,
                    "goals_scored": 0,
                    "goals_against": 0
                },
                "away": {
                    "games_played": 1,
                    "won": 1,
                    "draw": 0,
                    "lost": 0,
                    "goals_scored": 1,
                    "goals_against": 0
                },
                "points": 3,
                "description": "Championship Round",
                "recent_form": "W"
            },

    The unique id of the current round

    "
    :
    172104
    ,
    "team_id": 53,
    "country_id": 1161,
    "position_id": 3,
    "common_name": "J. Forrest",
    "display_name": "James Forrest",
    "fullname": "James Forrest",
    "firstname": "James",
    "lastname": "Forrest",
    "nationality": "Scotland",
    "birthdate": "07/07/1991",
    "birthcountry": "Scotland",
    "birthplace": "Prestwick",
    "height": "175 cm",
    "weight": null,
    "image_path": "https://cdn.sportmonks.com/images/soccer/players/8/172104.png"
    },
    {
    "player_id": 12724,
    "team_id": 382,
    "country_id": 462,
    "position_id": 4,
    "common_name": "D. Forrest",
    "display_name": "Danny Forrest",
    "fullname": "Danny Forrest",
    "firstname": "Danny",
    "lastname": "Forrest",
    "nationality": "England",
    "birthdate": "23/10/1984",
    "birthcountry": "England",
    "birthplace": "Keighley",
    "height": "180 cm",
    "weight": null,
    "image_path": "https://cdn.sportmonks.com/images/soccer/placeholder.png"
    },
    {
    "player_id": 174304,
    "team_id": 258,
    "country_id": 1161,
    "position_id": 4,
    "common_name": "A. Forrest",
    "display_name": "Alan Forrest",
    "fullname": "Alan Forrest",
    "firstname": "Alan",
    "lastname": "Forrest",
    "nationality": "Scotland",
    "birthdate": "09/09/1996",
    "birthcountry": "Scotland",
    "birthplace": "Irvine",
    "height": "175 cm",
    "weight": null,
    "image_path": "https://cdn.sportmonks.com/images/soccer/placeholder.png"
    },
    {
    "player_id": 174484,
    "team_id": null,
    "country_id": 1161,
    "position_id": 2,
    "common_name": "F. Forrest",
    "display_name": "Fraser Forrest",
    "fullname": "Fraser Forrest",
    "firstname": "Fraser",
    "lastname": "Forrest",
    "nationality": "Scotland",
    "birthdate": "14/09/1983",
    "birthcountry": "Scotland",
    "birthplace": "Galashiels",
    "height": null,
    "weight": null,
    "image_path": "https://cdn.sportmonks.com/images/soccer/placeholder.png"
    },
    {
    "player_id": 175004,
    "team_id": null,
    "country_id": 1161,
    "position_id": 2,
    "common_name": "E. Forrest",
    "display_name": "Eddie Forrest",
    "fullname": "Eddie Forrest",
    "firstname": "Eddie",
    "lastname": "Forrest",
    "nationality": "Scotland",
    "birthdate": "17/12/1978",
    "birthcountry": "Scotland",
    "birthplace": "Edinburgh",
    "height": "183 cm",
    "weight": "80 kg",
    "image_path": "https://cdn.sportmonks.com/images/soccer/placeholder.png"
    },

    The unique id of the position the player plays in

    common_name

    The common name the player is known for

    display_name

    The display name of the player. Often used to show in the lineup formation

    fullname

    The full name of the player

    firstname

    The first name of the player

    lastname

    The last name of the player

    nationality

    The nationality of the player

    birthdate

    The date of birth of the player

    birthcountry

    The country the player was born in

    birthplace

    The place the player was born in

    height

    The height of the player

    weight

    The weight of the player

    image_path

    The URL of the player image

    :
    8909
    ,
    "name": "Celtic Park",
    "surface": "grass",
    "address": "18 Kerrydale Street",
    "city": "Glasgow",
    "capacity": 60411,
    "image_path": "https://cdn.sportmonks.com/images/soccer/venues/13/8909.png",
    "coordinates": "55.849711,-4.205589"
    },
    {
    "id": 8914,
    "name": "Ibrox Stadium",
    "surface": "grass",
    "address": "150 Edmiston Drive",
    "city": "Glasgow",
    "capacity": 50817,
    "image_path": "https://cdn.sportmonks.com/images/soccer/venues/18/8914.png",
    "coordinates": "55.853206,-4.309256"
    },
    {
    "id": 8946,
    "name": "Easter Road Stadium",
    "surface": "grass",
    "address": "12 Albion Place",
    "city": "Edinburgh",
    "capacity": 20421,
    "image_path": "https://cdn.sportmonks.com/images/soccer/venues/18/8946.png",
    "coordinates": "55.961667,-3.165556"
    },
    {
    "id": 8906,
    "name": "Rugby Park",
    "surface": "artificial turf",
    "address": "Rugby Road",
    "city": "Kilmarnock",
    "capacity": 17889,
    "image_path": "https://cdn.sportmonks.com/images/soccer/venues/10/8906.png",
    "coordinates": "55.604225,-4.508122"
    },
    {
    "id": 8908,
    "name": "Global Energy Stadium",
    "surface": "grass",
    "address": "Jubilee Road",
    "city": "Dingwall",
    "capacity": 6541,
    "image_path": "https://cdn.sportmonks.com/images/soccer/venues/12/8908.png",
    "coordinates": "57.595947,-4.418914"
    },
    {
    "id": 8943,
    "name": "Tony Macaroni Arena",
    "surface": "grass",
    "address": "Almondvale Stadium Road",
    "city": "Livingston",
    "capacity": 8716,
    "image_path": "https://cdn.sportmonks.com/images/soccer/venues/15/8943.png",
    "coordinates": "55.886167,-3.522872"
    },
    {
    "id": 8928,
    "name": "Pittodrie Stadium",
    "surface": "grass",
    "address": "Pittodrie Street",
    "city": "Aberdeen",
    "capacity": 20866,
    "image_path": "https://cdn.sportmonks.com/images/soccer/venues/0/8928.png",
    "coordinates": "57.159167,-2.088889"
    },
    {
    "id": 8947,
    "name": "Tannadice Park",
    "surface": "grass",
    "address": "Tannadice Street",
    "city": "Dundee",
    "capacity": 14223,
    "image_path": "https://cdn.sportmonks.com/images/soccer/venues/19/8947.png",
    "coordinates": "56.474703,-2.968961"
    },
    {
    "id": 8922,
    "name": "Fir Park",
    "surface": "grass",
    "address": "Fir Park Street",
    "city": "Motherwell",
    "capacity": 13677,
    "image_path": "https://cdn.sportmonks.com/images/soccer/venues/26/8922.png",
    "coordinates": "55.779947,-3.980078"
    },
    {
    "id": 288196,
    "name": "The Hope CBD Stadium",
    "surface": "artificial turf",
    "address": "Cadzow Avenue",
    "city": "Hamilton",
    "capacity": 5510,
    "image_path": "https://cdn.sportmonks.com/images/soccer/venues/4/288196.png",
    "coordinates": "55.782156,-4.058503"
    },
    {
    "id": 8879,
    "name": "The Smisa Stadium",
    "surface": null,
    "address": null,
    "city": "Greenhill Road",
    "capacity": null,
    "image_path": null,
    "coordinates": "-17.04489,145.80236"
    },
    {
    "id": 219,
    "name": "McDiarmid Park",
    "surface": "grass",
    "address": "Crieff Road",
    "city": "Perth",
    "capacity": 10696,
    "image_path": "https://cdn.sportmonks.com/images/soccer/venues/27/219.png",
    "coordinates": "56.409686,-3.476928"
    }
    ],
    "
    :
    18326451
    ,
    "league_id": 818,
    "season_id": 17730,
    "stage_id": 77449623,
    "round_id": 257154,
    "group_id": 244868,
    "aggregate_id": null,
    "venue_id": 237914,
    "referee_id": null,
    "localteam_id": 149087,
    "visitorteam_id": 11388,
    "winner_team_id": null,
    "weather_report": {
    "code": "rain",
    "type": "light rain",
    "icon": "https://cdn.sportmonks.com/images/weather/10d.png",
    "temperature": {
    "temp": 76.64,
    "unit": "fahrenheit"
    },
    "temperature_celcius": {
    "temp": 24.8,
    "unit": "celcius"
    },
    "clouds": "84%",
    "humidity": "78%",
    "pressure": 1015,
    "wind": {
    "speed": "5.03 m/s",
    "degree": 287
    },
    "coordinates": {
    "lat": 3.7833,
    "lon": 11.3833
    },
    "updated_at": "2021-08-05T12:15:03.240060Z"
    },
    "commentaries": false,
    "attendance": null,
    "pitch": null,
    "details": null,
    "neutral_venue": false,
    "winning_odds_calculated": false,
    "formations": {
    "localteam_formation": null,
    "visitorteam_formation": null
    },
    "scores": {
    "localteam_score": 0,
    "visitorteam_score": 0,
    "localteam_pen_score": null,
    "visitorteam_pen_score": null,
    "ht_score": null,
    "ft_score": null,
    "et_score": null,
    "ps_score": null
    },
    "time": {
    "status": "NS",
    "starting_at": {
    "date_time": "2021-08-05 12:30:00",
    "date": "2021-08-05",
    "time": "12:30:00",
    "timestamp": 1628166600,
    "timezone": "UTC"
    },
    "minute": null,
    "second": null,
    "added_time": null,
    "extra_minute": null,
    "injury_time": null
    },
    "coaches": {
    "localteam_coach_id": null,
    "visitorteam_coach_id": null
    },
    "standings": {
    "localteam_position": 11,
    "visitorteam_position": 10
    },
    "assistants": {
    "first_assistant_id": null,
    "second_assistant_id": null,
    "fourth_official_id": null
    },
    "leg": "1/1",
    "colors": null,
    "deleted": false,
    "is_placeholder": false,
    "flatOdds": {
    "data": [
    {
    "bookmaker_id": 88,
    "bookmaker_event_id": null,
    "market_id": 1,
    "suspended": false,
    "odds": [
    {
    "value": "2.45",
    "handicap": null,
    "total": null,
    "label": "1",
    "probability": "40.82%",
    "dp3": "2.450",
    "american": 145,
    "factional": null,
    "winning": null,
    "stop": false,
    "last_update": {
    "date": "2021-08-05 12:15:51.351945",
    "timezone_type": 3,
    "timezone": "UTC"
    }
    },
    {
    "value": "2.65",
    "handicap": null,
    "total": null,
    "label": "X",
    "probability": "37.74%",
    "dp3": "2.650",
    "american": 165,
    "factional": null,
    "winning": null,
    "stop": false,
    "last_update": {
    "date": "2021-08-05 12:15:51.351966",
    "timezone_type": 3,
    "timezone": "UTC"
    }
    },
    {
    "value": "3.00",
    "handicap": null,
    "total": null,
    "label": "2",
    "probability": "33.33%",
    "dp3": "3.000",
    "american": 200,
    "factional": null,
    "winning": null,
    "stop": false,
    "last_update": {
    "date": "2021-08-05 12:15:51.351978",
    "timezone_type": 3,
    "timezone": "UTC"
    }
    }
    ]
    },
    {
    "bookmaker_id": 1,
    "bookmaker_event_id": null,
    "market_id": 1,
    "suspended": false,
    "odds": [
    {
    "value": "2.55",
    "handicap": null,
    "
    :
    18046196
    ,
    "predictions": {
    "btts": 50.665,
    "over_2_5": 47.688,
    "under_2_5": 52.309,
    "over_3_5": 25.994,
    "under_3_5": 74.003,
    "HT_over_0_5": 78.809,
    "HT_under_0_5": 21.188,
    "HT_over_1_5": 45.931,
    "HT_under_1_5": 54.065,
    "AT_over_0_5": 64.287,
    "AT_under_0_5": 35.71,
    "AT_over_1_5": 27.517,
    "AT_under_1_5": 72.48,
    "home": 49.407,
    "away": 25.156,
    "draw": 25.434,
    "correct_score": {
    "0-0": 7.566,
    "0-1": 7.791,
    "0-2": 4.012,
    "0-3": 1.377,
    "0-4": 0.354,
    "0-5": 0.073,
    "0-6": 0.013,
    "0-7": 0.002,
    "1-0": 11.74,
    "1-1": 12.09,
    "1-2": 6.225,
    "1-3": 2.137,
    "1-4": 0.55,
    "1-5": 0.113,
    "1-6": 0.019,
    "1-7": 0.003,
    "2-0": 9.109,
    "2-1": 9.38,
    "2-2": 4.83,
    "2-3": 1.658,
    "2-4": 0.427,
    "2-5": 0.088,
    "2-6": 0.015,
    "2-7": 0.002,
    "3-0": 4.712,
    "3-1": 4.852,
    "3-2": 2.498,
    "3-3": 0.857,
    "3-4": 0.221,
    "3-5": 0.045,
    "3-6": 0.008,
    "3-7": 0.001,
    "4-0": 1.828,
    "4-1": 1.882,
    "4-2": 0.969,
    "4-3": 0.333,
    "4-4": 0.086,
    "4-5": 0.018,
    "4-6": 0.003,
    "5-0": 0.567,
    "5-1": 0.584,
    "5-2": 0.301,
    "5-3": 0.103,
    "5-4": 0.027,
    "5-5": 0.005,
    "5-6": 0.001,
    "6-0": 0.147,
    "6-1": 0.151,
    "6-2": 0.078,
    "6-3": 0.027,
    "6-4": 0.007,
    "6-5": 0.001,
    "7-0": 0.033,
    "7-1": 0.033,
    "7-2": 0.017,
    "7-3": 0.006,
    "7-4": 0.002,
    "8-0": 0.006,
    "8-1": 0.006,
    "8-2": 0.003,
    "8-3": 0.001,
    "9-0": 0.001,
    "9-1": 0.001,
    "9-2": 0.001
    }
    }
    },
    {
    "fixture_id": 18325605,
    "predictions": {
    "btts": 47.947,
    "over_2_5": 58.407,
    "under_2_5": 41.586,
    "over_3_5": 36.004,
    "under_3_5": 63.99,
    "HT_over_0_5": 53.489,
    "HT_under_0_5": 46.504,
    "HT_over_1_5": 17.884,
    "HT_under_1_5": 82.109,
    "AT_over_0_5": 89.636,
    "AT_under_0_5": 10.358,
    "AT_over_1_5": 66.149,
    "AT_under_1_5": 33.845,
    "home": 11.047,
    "away": 71.357,
    "draw": 17.59,
    "correct_score": {
    "0-0": 4.817,
    "0-1": 10.92,
    "0-2": 12.38,
    "0-3": 9.361,
    "0-4": 5.306,
    "0-5": 2.406,
    "0-6": 0.909,
    "0-7": 0.295,
    "0-8": 0.083,
    "0-9": 0.021,
    "1-0": 3.688,
    "1-1": 8.363,
    "1-2": 9.481,
    "1-3": 7.166,
    "1-4": 4.062,
    "1-5": 1.842,
    "1-6": 0.696,
    "1-7": 0.226,
    "1-8": 0.064,
    "1-9": 0.016,
    "2-0": 1.412,
    "2-1": 3.201,
    "2-2": 3.629,
    "
    :
    8
    ,
    "active": true,
    "type": "domestic",
    "legacy_id": 29,
    "country_id": 462,
    "logo_path": "https://cdn.sportmonks.com/images/soccer/leagues/8/8.png",
    "name": "Premier League",
    "is_cup": false,
    "is_friendly": false,
    "current_season_id": 18378,
    "current_round_id": null,
    "current_stage_id": 77453700,
    "live_standings": true,
    "coverage": {
    "predictions": true,
    "topscorer_goals": true,
    "topscorer_assists": true,
    "topscorer_cards": true
    },
    "predictability": {
    "data": {
    "league_id": 8,
    "hit_ratio": "0.56",
    "log_loss": -0.9649,
    "predictability": "good",
    "predictive_power": "up",
    "historical_log_loss": {
    "3ways-ft": -1.037,
    "away_overunder05": -0.5714,
    "away_overunder15": -0.7029,
    "btts": -0.7107,
    "home_overunder05": -0.5668,
    "home_overunder15": -0.7122,
    "overunder15": -0.5005,
    "overunder25": -0.7064,
    "overunder35": -0.6474,
    "scores": -3.3161
    },
    "model_hit_ratio": {
    "3ways-ft": 0.56,
    "away_overunder05": 0.71,
    "away_overunder15": 0.67,
    "btts": 0.58,
    "home_overunder05": 0.74,
    "home_overunder15": 0.67,
    "overunder15": 0.82,
    "overunder25": 0.57,
    "overunder35": 0.68,
    "scores": 0.09
    },
    "model_predictability": {
    "3ways-ft": "good",
    "away_overunder05": "high",
    "away_overunder15": "high",
    "btts": "medium",
    "home_overunder05": "good",
    "home_overunder15": "high",
    "overunder15": "good",
    "overunder25": "medium",
    "overunder35": "medium",
    "scores": "high"
    },
    "model_predictive_power": {
    "3ways-ft": "up",
    "away_overunder05": "up",
    "away_overunder15": "unchanged",
    "btts": "unchanged",
    "home_overunder05": "unchanged",
    "home_overunder15": "unchanged",
    "overunder15": "up",
    "overunder25": "up",
    "overunder35": "unchanged",
    "scores": "up"
    },
    "model_log_loss": {
    "3ways-ft": -0.9649,
    "away_overunder05": -0.5203,
    "away_overunder15": -0.6168,
    "btts": -0.676,
    "home_overunder05": -0.5285,
    "home_overunder15": -0.6431,
    "overunder15": -0.4638,
    "overunder25": -0.6711,
    "overunder35": -0.6304,
    "scores": -2.7332
    },
    "updated_at": {
    "date": "2021-05-25 01:00:12.000000",
    "timezone_type": 3,
    "timezone": "UTC"
    }
    }
    }
    },
    {
    "id": 9,
    "active": true,
    "type": "domestic",
    "legacy_id": 30,
    "country_id": 462,
    "logo_path": "https://cdn.sportmonks.com/images/soccer/leagues/9/9.png",
    "name": "Championship",
    "is_cup": false,
    "is_friendly": false,
    "current_season_id": 18432,
    "current_round_id": null,
    "current_stage_id": null,
    "live_standings": true,
    "coverage": {
    "predictions": true,
    "topscorer_goals": true,
    "topscorer_assists": true,
    "topscorer_cards": true
    },
    "predictability": {
    "data": {
    "league_id": 9,
    "hit_ratio": "0.41",
    "log_loss": -1.0651,
    "predictability": "medium",
    "predictive_power": "up",
    "historical_log_loss": {
    "3ways-ft": -1.0993,
    "away_overunder05": -0.6043,
    "away_overunder15": -0.6429,
    "btts": -0.7066,
    "home_overunder05": -0.6095,
    "home_overunder15": -0.6749,
    "overunder15": -0.5823,
    "overunder25": -0.7024,
    "overunder35": -0.6695,
    "scores": -3.258
    },
    "model_hit_ratio": {

    Pagination

    NO

    Allowed nested includes

    0

    hashtag
    Parameters

    No parameters available for this endpoint.

    hashtag
    Include options

    No includes available for this endpoint.

    hashtag
    Example response

    https://soccer.sportmonks.com/api/v2.0/standings/season/17420/date/2021-05-05?api_token={API_TOKEN}
    "data": [
            {
                "position"
    

    Field

    Description

    position

    The actual position in the rankings in the stage

    team_id

    The unique team id of the team in that position in the stage

    team_name

    The team name in that position in the stage

    round_id

    circle-info

    Check this endpoint in Postman. arrow-up-right

    Endpoint details

    Authorization

    API Key

    YES

    Allowed nested includes

    2

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

    cupslast

    When provided via the request url the cups will be put on the end of the response.

    hashtag
    Include options

    country season seasons

    Includes are the cornerstone of our API and allow you to enrich and customize your requests. This flexibility is what distinguishes us from our competitors.

    You can learn more about what includes are and how they work here:

    hashtag
    Example response

    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

    circle-info

    Check this endpoint in Postman. arrow-up-right

    Endpoint details

    Authorization

    API Key

    Pagination

    Includeschevron-right

    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.

    Pagination

    YES

    Allowed nested includes

    3

    Available parameters

    page

    The number of the page you want to browse. Can be used by adding &page= etc to your request url.

    include

    Enrich the API with more data and/or nested includes. Can be used by adding &include= etc. to your request url.

    https://soccer.sportmonks.com/api/v2.0/continents?api_token={API_TOKEN}
    Includeschevron-right
    arrow-up-right
    "data": [
            {
                "id": 1,
                "name": "Europe"
            },
            {
                "id": 2,
                "name": "Asia"
            },
            {
                "id": 3,
                "name": "Africa"
            },
            {
                "id": 4,
                "name": "Oceania"
            },
            {
                "id": 5,
                "name": "Antarctica"
            },
            {
                "id": 6,
                "name": "North America"
            },
            {
                "id": 7,
                "name": "South America"
            }
        ]

    GET Topscorers Aggregated by Season ID

    This Topscorers endpoint returns the Aggregated Topscorers by Season. This means that all stages are summed, also preliminary stages.

    hashtag
    GET Topscorers Aggregated by season ID

    Endpoint details

    Authorization

    hashtag
    Parameters

    hashtag
    Include options

    aggregatedGoalscorers.player aggregatedGoalscorers.player.team aggregatedCardscorers.player aggregatedCardscorers.player.team aggregatedAssistscorers.player aggregatedAssistscorers.player.team aggregatedGoalscorers.team aggregatedCardscorers.team aggregatedAssistscorers.team

    Includes are the cornerstone of our API and allow you to enrich and customize your requests. This flexibility is what distinguishes us from our competitors.

    You can learn more about what includes are and how they work here:

    hashtag
    Example response

    Season Field Description

    circle-info

    Check this endpoint in Postman.

    GET Topscorers by Season ID

    hashtag
    GET Topscorers by season ID

    Endpoint details

    Authorization

    API Key

    hashtag
    Parameters

    hashtag
    Include options

    goalscorers.player.team cardscorers.player.team assistscorers.player.team goalscorers.team cardscorers.team assistscorers.team goalscorers.player cardscorers.player assistscorers.player

    Includes are the cornerstone of our API and allow you to enrich and customize your requests. This flexibility is what distinguishes us from our competitors.

    You can learn more about what includes are and how they work here:

    hashtag
    Example response

    Season Field Description

    circle-info

    Check this endpoint in Postman.

    GET Rivals by Team ID

    hashtag
    GET Rivals by Team ID

    Endpoint details

    Authorization

    API Key

    hashtag
    Parameters

    hashtag
    Include options

    country squad coach transfers sidelined stats venue fifaranking uefaranking visitorFixtures localFixtures visitorResults latest

    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:

    hashtag
    Example response

    GET All Countries

    hashtag
    GET All Countries

    GET Standings by Season ID

    hashtag
    GET Standings by Season ID

    https://soccer.sportmonks.com/api/v2.0/teams/season/16020?api_token={API_TOKEN}
    "data": [
            {
                "id": 85,
                "legacy_id": 146,
                "name": "København",
                "short_code": "COP",
                "twitter": null,
                "country_id": 320,
                "national_team": false,
                "founded": 1992,
                "logo_path": "https://cdn.sportmonks.com/images//soccer/teams/21/85.png",
                "venue_id": 5655,
                "current_season_id": 18334,
                "is_placeholder": false
            },
            {
                "id": 86,
                "legacy_id": 522,
                "name": "Silkeborg",
                "short_code": "SIL",
                "twitter": null,
                "country_id": 320,
                "national_team": false,
                "founded": 1917,
                "logo_path": "https://cdn.sportmonks.com/images//soccer/teams/22/86.png",
                "venue_id": 85371,
                "current_season_id": 18334,
                "is_placeholder": false
            },
            {
                "id": 211,
                "legacy_id": 631,
                "name": "Horsens",
                "short_code": "ACH",
                "twitter": null,
                "country_id": 320,
                "national_team": false,
                "founded": 1994,
                "logo_path": "https://cdn.sportmonks.com/images//soccer/teams/19/211.png",
                "venue_id": 5661,
                "current_season_id": 18342,
                "is_placeholder": false
            },
            {
                "id": 293,
                "legacy_id": null,
                "name": "Brøndby",
                "short_code": "SLO",
                "twitter": null,
                "country_id": 320,
                "national_team": false,
                "founded": 1964,
                "logo_path": "https://cdn.sportmonks.com/images//soccer/teams/5/293.png",
                "venue_id": 5659,
                "current_season_id": 18334,
                "is_placeholder": false
            },
            {
                "id": 390,
                "legacy_id": null,
                "name": "SønderjyskE",
                "short_code": "SON",
                "twitter": null,
                "country_id": 320,
                "national_team": false,
                "founded": 2004,
                "logo_path": "https://cdn.sportmonks.com/images//soccer/teams/6/390.png",
                "venue_id": 5653,
                "current_season_id": 18334,
                "is_placeholder": false
            },
            {
                "id": 939,
                "legacy_id": 513,
                "name": "Midtjylland",
                "short_code": "FCM",
                "twitter": null,
                "country_id": 320,
                "national_team": false,
                "founded": 1999,
                "logo_path": "https://cdn.sportmonks.com/images//soccer/teams/11/939.png",
                "venue_id": 342,
                "current_season_id": 18334,
                "is_placeholder": false
            },
    https://soccer.sportmonks.com/api/v2.0/standings/season/{season_ID}/date/{date_time}
    https://soccer.sportmonks.com/api/v2.0/leagues?api_token={API_TOKEN}
     "data": [
            {
                "id": 2,
                "active": true,
                "type": "cup_international",
                "legacy_id": 11,
                "country_id": 41,
                "logo_path": "https://cdn.sportmonks.com/images/soccer/leagues/2.png",
                "name": "Champions League",
                "is_cup": true,
                "is_friendly": false,
                "current_season_id": 18346,
                "current_round_id": null,
                "current_stage_id": 77453623,
                "live_standings": true,
                "coverage": {
                    "predictions": false,
                    "topscorer_goals": true,
                    "topscorer_assists": true,
                    "topscorer_cards": true
                }
            },
            {
                "id": 5,
                "active": true,
                "type": "cup_international",
                "legacy_id": 12,
                "country_id": 41,
                "logo_path": "https://cdn.sportmonks.com/images/soccer/leagues/5.png",
                "name": "Europa League",
                "is_cup": true,
                "is_friendly": false,
                "current_season_id": 18629,
                "current_round_id": null,
                "current_stage_id": 77454501,
                "live_standings": true,
                "coverage": {
                    "predictions": false,
                    "topscorer_goals": true,
                    "topscorer_assists": true,
                    "topscorer_cards": true
                }
            },
            {
                "id": 8,
                "active": true,
                "type": "domestic",
                "legacy_id": 29,
                "country_id": 462,
                "logo_path": "https://cdn.sportmonks.com/images/soccer/leagues/8/8.png",
                "name": "Premier League",
                "is_cup": false,
                "is_friendly": false,
                "current_season_id": 18378,
                "current_round_id": null,
                "current_stage_id": 77453700,
                "live_standings": true,
                "coverage": {
                    "predictions": true,
                    "topscorer_goals": true,
                    "topscorer_assists": true,
                    "topscorer_cards": true
                }
            },
            {
                "id": 9,
                "active": true,
                "type": "domestic",
                "legacy_id": 30,
                "country_id": 462,
                "logo_path": "https://cdn.sportmonks.com/images/soccer/leagues/9/9.png",
                "name": "Championship",
                "is_cup": false,
                "is_friendly": false,
                "current_season_id": 18432,
                "current_round_id": null,
                "current_stage_id": null,
                "live_standings": true,
                "coverage": {
                    "predictions": true,
                    "topscorer_goals": true,
                    "topscorer_assists": true,
                    "topscorer_cards": true
                }
            },
    https://soccer.sportmonks.com/api/v2.0/leagues
    https://soccer.sportmonks.com/api/v2.0/topscorers/season/{ID}/aggregated
    https://soccer.sportmonks.com/api/v2.0/topscorers/season/{ID}
    https://soccer.sportmonks.com/api/v2.0/teams/{ID}/rivals
    Run in Postman
    Run in Postman
    Run in Postman
    Run in Postman
    Run in Postman
    Run in Postman
    Run in Postman
    upcoming
    goalscorers
    cardscorers
    assistscorers
    aggregatedGoalscorers
    aggregatedCardscorers
    aggregatedAssistscorers
    league
    activeSeasons
    trophies

    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.

    Pagination

    NO

    Allowed nested includes

    3

    Available parameters

    include

    Enrich the API with more data and/or nested includes. Can be used by adding &include= etc to your request url.

    Field

    Description

    id

    The unique id of the team

    legacy_id

    This was for our API version 1.0. It's only of use for old users of our API

    name

    The name of the team

    short_code

    https://soccer.sportmonks.com/api/v2.0/teams/8/rivals?api_token={API_TOKEN}
    Includeschevron-right
    "data": {
            "id": 8,
            "legacy_id": 119,
            "name": "Liverpool",
            "short_code": "LIV",
            "twitter": "@LFC",
            "country_id": 462,
            "national_team": false,
            "founded": 1892,
            "logo_path": "https://cdn.sportmonks.com/images//soccer/teams/8/8.png",
            "venue_id": 230,
            "current_season_id": 18378,
            "is_placeholder": false,
            "rivals": {
                "data": [
                    {
                        "id": 13,
                        "legacy_id": 165,
                        "name": "Everton",
                        "short_code": "EVE",
                        "twitter": "@Everton",
                        "country_id": 462,
                        "national_team": false,
                        "founded": 1878,
                        "logo_path": "https://cdn.sportmonks.com/images//soccer/teams/13/13.png",
                        "venue_id": 12,
                        "current_season_id": 18378,
                        "is_placeholder": false
                    }
                ]
            }
        },

    The short code of the team

    here
    Run in Postman
    here
    Run in Postman
    Run in Postman
    here
    Run in Postman
    Run in Postman
    Run in Postman
    Run in Postman
    Run in Postman

    season_id

    The unique id of the current season

    round_id

    The unique id of the current round

    round_name

    The name of the round

    type

    Indicates what kind of type this stage is

    stage_id

    The unique id of the current stage

    stage_name

    The name of the stage

    Topscorers Field Description

    Field

    Description

    position

    The actual position in the rankings in the stage

    player_id

    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

    API Key

    Pagination

    NO

    Allowed nested includes

    3

    Available parameters

    include

    Enrich the API with more data and/or nested includes. Can be used by adding &include= etc to your request url.

    Field

    Description

    id

    The unique id of the current stage

    name

    The name of the stage

    league_id

    https://soccer.sportmonks.com/api/v2.0/topscorers/season/17141/aggregated?api_token={API_TOKEN}
    arrow-up-right
     "data": {
            "id": 17141,
            "name": "2020/2021",
            "league_id": 501,
            "is_current_season": false,
            "current_round_id": null,
            "current_stage_id": null,
            "aggregatedGoalscorers": {
                "data": [
                    {
                        "position": 1,
                        "season_id": 17141,
                        "player_id": 96792,
                        "team_id": 53,
                        "stage_id": null,
                        "goals": 18,
                        "penalty_goals": 5,
                        "type": "aggregated_goals"
                    },
                    {
                        "position": 2,
                        "season_id": 17141,
                        "player_id": 173059,
                        "team_id": 66,
                        "stage_id": null,
                        "goals": 14,
                        "penalty_goals": 2,
                        "type": "aggregated_goals"
                    },
                    {
                        "position": 3,
                        "season_id": 17141,
                        "player_id": 4561,
                        "team_id": 62,
                        "stage_id": null,
                        "goals": 14,
                        "penalty_goals": 0,
                        "type": "aggregated_goals"
                    },
                    {
                        "position": 4,
                        "season_id": 17141,
                        "player_id": 172795,
                        "team_id": 66,
                        "stage_id": null,
                        "goals": 12,
                        "penalty_goals": 5,
                        "type": "aggregated_goals"
                    },
                    {
                        "position": 5,
                        "season_id": 17141,
                        "player_id": 92276,
                        "team_id": 62,
                        "stage_id": null,
                        "goals": 12,
                        "penalty_goals": 0,
                        "type": "aggregated_goals"
                    },
                    {
                        "position": 6,
                        "season_id": 17141,
                        "player_id": 758,
                        "team_id": 62,
                        "stage_id": null,
                        "goals": 12,
                        "penalty_goals": 7,
                        "type": "aggregated_goals"
                    },
                    {
                        "position": 7,
                        "season_id": 17141,
                        "player_id": 8934,
                        "team_id": 309,
                        "stage_id": null,
                        "goals": 11,
                        "penalty_goals": 1,
                        "type": "aggregated_goals"
                    },
                    {
                        "position": 8,
                        "season_id": 17141,
                        "player_id": 150759,
                        "team_id": 53,
                        "stage_id": null,
                        "goals": 10,
                        "penalty_goals": 0,
                        "type": "aggregated_goals"
                    },
                    {
                        "position": 9,
                        "season_id": 17141,
                        "player_id": 3387,
                        "team_id": 62,
                        "stage_id": null,
                        "goals": 10,
                        "penalty_goals": 0,
                        "type": "aggregated_goals"
                    },

    The unique league id the stage belongs to

    season_id

    The unique id of the current season

    round_id

    The unique id of the current round

    round_name

    The name of the round

    type

    Indicates what kind of type this stage is

    stage_id

    The unique id of the current stage

    stage_name

    The name of the stage

    Topscorers Field Description

    Field

    Description

    position

    The actual position in the rankings in the stage

    player_id

    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

    Pagination

    NO

    Allowed nested includes

    3

    Available parameters

    include

    Enrich the API with more data and/or nested includes. Can be used by adding &include= etc to your request url.

    Field

    Description

    id

    The unique id of the current stage

    name

    The name of the stage

    league_id

    https://soccer.sportmonks.com/api/v2.0/topscorers/season/17141?api_token={API_TOKEN}
    Includeschevron-right
    arrow-up-right
    "data": {
            "id": 17141,
            "name": "2020/2021",
            "league_id": 501,
            "is_current_season": false,
            "current_round_id": null,
            "current_stage_id": null,
            "goalscorers": {
                "data": [
                    {
                        "position": 1,
                        "season_id": 17141,
                        "player_id": 1836,
                        "team_id": 180,
                        "stage_id": 77447500,
                        "goals": 5,
                        "penalty_goals": 1,
                        "type": "goals"
                    },
                    {
                        "position": 1,
                        "season_id": 17141,
                        "player_id": 96792,
                        "team_id": 53,
                        "stage_id": 77447501,
                        "goals": 16,
                        "penalty_goals": 5,
                        "type": "goals"
                    },
                    {
                        "position": 2,
                        "season_id": 17141,
                        "player_id": 4561,
                        "team_id": 62,
                        "stage_id": 77447500,
                        "goals": 4,
                        "penalty_goals": 0,
                        "type": "goals"
                    },
                    {
                        "position": 2,
                        "season_id": 17141,
                        "player_id": 173059,
                        "team_id": 66,
                        "stage_id": 77447501,
                        "goals": 12,
                        "penalty_goals": 2,
                        "type": "goals"
                    },
                    {
                        "position": 3,
                        "season_id": 17141,
                        "player_id": 8934,
                        "team_id": 309,
                        "stage_id": 77447500,
                        "goals": 3,
                        "penalty_goals": 0,
                        "type": "goals"
                    },
                    {
                        "position": 3,
                        "season_id": 17141,
                        "player_id": 172795,
                        "team_id": 66,
                        "stage_id": 77447501,
                        "goals": 11,
                        "penalty_goals": 4,
                        "type": "goals"
                    },
                    {
                        "position": 4,
                        "season_id": 17141,
                        "player_id": 121792,
                        "team_id": 496,
                        "stage_id": 77447500,
                        "goals": 3,
                        "penalty_goals": 1,
                        "type": "goals"
                    },
                    {
                        "position": 4,
                        "season_id": 17141,
                        "player_id": 92276,
                        "team_id": 62,
                        "stage_id": 77447501,
                        "goals": 11,
                        "penalty_goals": 0,
                        "type": "goals"
                    },
                    {
                        "position": 5,
                        "season_id": 17141,
                        "player_id": 12314,
                        "team_id": 180,
                        "stage_id": 77447500,
                        "goals": 3,
                        "penalty_goals": 0,
                        "type": "goals"
                    },

    The unique league id the stage belongs to

    :
    1
    ,
    "team_id": 9,
    "team_name": "Manchester City",
    "short_code": "MCI",
    "team_logo": "https://cdn.sportmonks.com/images/soccer/teams/9/9.png",
    "overall": {
    "games_played": 34,
    "won": 25,
    "draw": 5,
    "lost": 4,
    "goals_scored": 71,
    "goals_against": 24,
    "goal_diff": 47
    },
    "home": {
    "games_played": 17,
    "won": 12,
    "draw": 2,
    "lost": 3,
    "goals_scored": 37,
    "goals_against": 15
    },
    "away": {
    "games_played": 17,
    "won": 13,
    "draw": 3,
    "lost": 1,
    "goals_scored": 34,
    "goals_against": 9
    },
    "points": 80,
    "description": "UEFA Champions League",
    "recent_form": "WLDWDWDLWWDDWWWWWWWWWWWWWWWLWWWLWW"
    },
    {
    "position": 2,
    "team_id": 14,
    "team_name": "Manchester United",
    "short_code": "MUN",
    "team_logo": "https://cdn.sportmonks.com/images/soccer/teams/14/14.png",
    "overall": {
    "games_played": 33,
    "won": 19,
    "draw": 10,
    "lost": 4,
    "goals_scored": 64,
    "goals_against": 35,
    "goal_diff": 29
    },
    "home": {
    "games_played": 16,
    "won": 9,
    "draw": 3,
    "lost": 4,
    "goals_scored": 34,
    "goals_against": 21
    },
    "away": {
    "games_played": 17,
    "won": 10,
    "draw": 7,
    "lost": 0,
    "goals_scored": 30,
    "goals_against": 14
    },
    "points": 67,
    "description": "UEFA Champions League",
    "recent_form": "LWLWDLWWWWDWWDWWWDWLDWDDWDDWWWWWD"
    },
    {
    "position": 3,
    "team_id": 42,
    "team_name": "Leicester City",
    "short_code": "LEI",
    "team_logo": "https://cdn.sportmonks.com/images/soccer/teams/10/42.png",
    "overall": {
    "games_played": 34,
    "won": 19,
    "draw": 6,
    "lost": 9,
    "goals_scored": 61,
    "goals_against": 39,
    "goal_diff": 22
    },
    "home": {
    "games_played": 17,
    "won": 9,
    "draw": 1,
    "lost": 7,
    "goals_scored": 30,
    "goals_against": 22
    },
    "away": {
    "games_played": 17,
    "won": 10,
    "draw": 5,
    "lost": 2,
    "goals_scored": 31,
    "goals_against": 17
    },
    "points": 63,
    "description": "UEFA Champions League",
    "recent_form": "WWWLLWWWLLWWLWDDWWWDLWDWWLDWWLLWWD"
    },

    The unique id of the current round

    round_name

    The name of the round

    group_id

    The unique id of the group, in which the team participates in

    group_name

    The name of the group, in which the team participates in

    overall

    The overall results of the team, i.e., the number of games, points and goals

    home

    The home results of the team, i.e., the number of games, points and goals

    away

    The away results of the team, i.e., the number of games, points and goals

    total

    The total points of the team and their goal difference

    results

    The standing rules of the place the team is in

    points

    The accumulated number of points the team has

    recent_form

    The recent form of the team

    status

    Will be available in API 3.0: Indicates if the team moves up on down based on the last standings.

    YES

    Allowed nested includes

    2

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

    hashtag
    Include options

    leagues continent covid

    Includes are the cornerstone of our API and allow you to enrich and customize your requests. This flexibility is what distinguishes us from our competitors.

    You can learn more about what includes are and how they work here:

    hashtag
    Example response

    https://soccer.sportmonks.com/api/v2.0/countries?api_token={API_TOKEN}
    "data": [
            {
                "id"
    
    circle-info

    Check this endpoint in Postman. arrow-up-right

    Endpoint details

    Authorization

    API Key

    Pagination

    Includeschevron-right

    NO

    Allowed nested includes

    2

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

    stage_ids

    A Comma separated list of stage ids. Can be used by adding &stage_ids= etc. to your request url.

    group_ids

    A Comma separated list of group ids. Can be used by adding &group_ids= etc. to your request url.

    hashtag
    Include options

    circle-info

    Note that includes on this endpoint must be prefixed by "standings."

    team league season round stages

    Includes are the cornerstone of our API and allow you to enrich and customize your requests. This flexibility is what distinguishes us from our competitors.

    You can learn more about what includes are and how they work here:

    hashtag
    Example response

    Season Field Description

    Field

    Description

    id

    The unique id of the current stage

    name

    The name of the stage

    league_id

    Standings Field Description

    circle-info

    Check this endpoint in Postman. arrow-up-right

    Endpoint details

    Authorization

    API Key

    Pagination

    Includeschevron-right

    Indicates what kind of league this is. Possible values: 'domestic', 'cup', 'international'. More values can be found here

    legacy_id

    This was for our API version 1.0. It's only of use for old users of our API

    country_id

    The unique country id the league is played in

    logo_path

    The logo URL path of the league

    name

    The name of the league

    is_cup

    Indicates if the league is a cup or not. Possible values are 'true' or 'false'

    current_season_id

    The unique id of the current season

    current_round_id

    The unique id of the current round

    current_stage_id

    The unique id of the current stage

    live_standings

    Indicates if the league covers live standings

    coverage

    Opens an array of partial coverage for the league

    predictions

    Indicates if the league covers predictions

    topscorers_goals

    Indicates if the league covers goal topscorers

    topscorers_assists

    Indicates if the league covers assists topscorers

    topscorers_cards

    Indicates if the league covers cards topscorers

    GET Deleted Fixtures

    hashtag
    GET Deleted Fixtures

    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.

    hashtag
    Overview

    1. What is Football API 2.0?

    https://soccer.sportmonks.com/api/v2.0/countries
    https://soccer.sportmonks.com/api/v2.0/standings/season/17420?api_token={API_TOKEN}
    "data": [
            {
                "id": 77448322,
                "name": "Regular Season",
                "league_id": 8,
                "season_id": 17420,
                "round_id": 202038,
                "round_name": 38,
                "type": "Group Stage",
                "stage_id": 77448322,
                "stage_name": "Regular Season",
                "resource": "stage",
                "standings": {
                    "data": [
                        {
                            "position": 1,
                            "team_id": 9,
                            "team_name": "Manchester City",
                            "round_id": 202038,
                            "round_name": 38,
                            "group_id": null,
                            "group_name": null,
                            "overall": {
                                "games_played": 38,
                                "won": 27,
                                "draw": 5,
                                "lost": 6,
                                "goals_scored": 83,
                                "goals_against": 32,
                                "points": 86
                            },
                            "home": {
                                "games_played": 19,
                                "won": 13,
                                "draw": 2,
                                "lost": 4,
                                "goals_scored": 43,
                                "goals_against": 17,
                                "points": 41
                            },
                            "away": {
                                "games_played": 19,
                                "won": 14,
                                "draw": 3,
                                "lost": 2,
                                "goals_scored": 40,
                                "goals_against": 15,
                                "points": 45
                            },
                            "total": {
                                "goal_difference": "51",
                                "points": 86
                            },
                            "result": "UEFA Champions League",
                            "points": 86,
                            "recent_form": "WLWLW",
                            "status": null
                        },
                        {
                            "position": 2,
                            "team_id": 14,
                            "team_name": "Manchester United",
                            "round_id": 202038,
                            "round_name": 38,
                            "group_id": null,
                            "group_name": null,
                            "overall": {
                                "games_played": 38,
                                "won": 21,
                                "draw": 11,
                                "lost": 6,
                                "goals_scored": 73,
                                "goals_against": 44,
                                "points": 74
                            },
                            "home": {
                                "games_played": 19,
                                "won": 9,
                                "draw": 4,
                                "lost": 6,
                                "goals_scored": 38,
                                "goals_against": 28,
                                "points": 31
                            },
                            "away": {
                                "games_played": 19,
                                "won": 12,
                                "draw": 7,
                                "lost": 0,
                                "goals_scored": 35,
                                "goals_against": 16,
                                "points": 43
                            },
                            "total": {
                                "goal_difference": "29",
                                "points": 74
                            },
                            "result": "UEFA Champions League",
                            "points": 74,
                            "recent_form": "WLLDW",
                            "status": null
                        },
    https://soccer.sportmonks.com/api/v2.0/standings/season/{season_ID}
    Run in Postman
    Run in Postman

    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

    Run in Postman

    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

    Run in Postman

    The unique id of the group, in which the team participates in

    group_name

    The name of the group, in which the team participates in

    overall

    The overall results of the team, i.e., the number of games, points and goals

    home

    The home results of the team, i.e., the number of games, points and goals

    away

    The away results of the team, i.e., the number of games, points and goals

    total

    The total points of the team and their goal difference

    results

    The standing rules of the place the team is in

    points

    The accumulated number of points the team has

    recent_form

    The recent form of the team

    status

    Will be available in API 3.0: Indicates if the team moves up on down based on the last standings.

    The unique league id the stage belongs to

    season_id

    The unique id of the current season

    round_id

    The unique id of the current round

    round_name

    The name of the round

    type

    Indicates what kind of type this stage is

    stage_id

    The unique id of the current stage

    stage_name

    The name of the stage

    Field

    Description

    position

    The actual position in the rankings in the stage

    team_id

    The unique team id of the team in that position in the stage

    team_name

    The team name in that position in the stage

    round_id

    The unique id of the current round

    round_name

    The name of the round

    group_id

    :
    2
    ,
    "name": "Poland",
    "image_path": "https://cdn.sportmonks.com/images/countries/png/short/pl.png",
    "extra": {
    "continent": "Europe",
    "sub_region": "Eastern Europe",
    "world_region": "EMEA",
    "fifa": "POL",
    "iso": "POL",
    "iso2": "PL",
    "longitude": "19.37775993347168",
    "latitude": "52.147850036621094",
    "flag": "<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"1280\" height=\"800\" viewBox=\"0 0 16 10\"><path fill=\"#fff\" d=\"M0 0h16v10h-16z\"/><path fill=\"#dc143c\" d=\"M0 5h16v5h-16z\"/></svg>\n"
    }
    },
    {
    "id": 5,
    "name": "Brazil",
    "image_path": "https://cdn.sportmonks.com/images/countries/png/short/br.png",
    "extra": {
    "continent": "Americas",
    "sub_region": "South America",
    "world_region": "AMER",
    "fifa": "BRA",
    "iso": "BRA",
    "iso2": "BR",
    "longitude": "-52.97311782836914",
    "latitude": "-10.81045150756836",
    "flag": "<svg version=\"1\" xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\" width=\"720\" height=\"504\" viewBox=\"-2100 -1470 4200 2940\"><defs><path id=\"i\" d=\"M-31.5 0h33a30 30 0 0 0 30-30v-10a30 30 0 0 0-30-30h-33zm13-13h19a19 19 0 0 0 19-19v-6a19 19 0 0 0-19-19h-19z\" fill-rule=\"evenodd\"/><path id=\"j\" d=\"M-31.5 0h63v-13h-51v-18h40v-12h-40v-14h48v-13h-60z\"/><path id=\"l\" d=\"M-26.25 0h52.5v-12h-40.5v-16h33v-12h-33v-11h39.25v-12h-51.25z\"/><g id=\"m\"><clipPath id=\"b\"><path d=\"M-31.5 0v-70h63v70zm31.5-47v12h31.5v-12z\"/></clipPath><use xlink:href=\"#a\" clip-path=\"url(#b)\"/><path d=\"M5-35h26.5v10h-26.5zM21.5-35h10v35h-10z\"/></g><path id=\"k\" d=\"M-31.5 0h12v-48l14 48h11l14-48v48h12v-70h-17.5l-14 48-14-48h-17.5z\"/><path id=\"a\" d=\"M0 0a31.5 35 0 0 0 0-70 31.5 35 0 0 0 0 70m0-13a18.5 22 0 0 0 0-44 18.5 22 0 0 0 0 44\" fill-rule=\"evenodd\"/><path id=\"c\" d=\"M-31.5 0h13v-26h28a22 22 0 0 0 0-44h-40zm13-39h27a9 9 0 0 0 0-18h-27z\" fill-rule=\"evenodd\"/><g id=\"h\"><use xlink:href=\"#c\"/><path d=\"M28 0c0-10 0-32-15-32h-19c22 0 22 22 22 32\"/></g><path id=\"n\" d=\"M-15.75-22c0 7 6.75 10.5 16.75 10.5s14.74-3.25 14.75-7.75c0-14.25-46.75-5.25-46.5-30.25.25-21.5 24.75-20.5 33.75-20.5s26 4 25.75 21.25h-15.25c0-7.5-7-10.25-15-10.25-7.75 0-13.25 1.25-13.25 8.5-.25 11.75 46.25 4 46.25 28.75 0 18.25-18 21.75-31.5 21.75-11.5 0-31.55-4.5-31.5-22z\"/><g id=\"f\" fill=\"#fff\"><g id=\"e\"><path id=\"d\" d=\"M.309-.951l-.309.951.476.155\"/><use xlink:href=\"#d\" transform=\"scale(-1 1)\"/></g><use xlink:href=\"#e\" transform=\"rotate(72)\"/><use xlink:href=\"#e\" transform=\"rotate(-72)\"/><use xlink:href=\"#e\" transform=\"rotate(144)\"/><use xlink:href=\"#e\" transform=\"rotate(-144)\"/></g><use id=\"o\" xlink:href=\"#f\" transform=\"scale(31.5)\"/><use id=\"p\" xlink:href=\"#f\" transform=\"scale(26.25)\"/><use id=\"r\" xlink:href=\"#f\" transform=\"scale(21)\"/><use id=\"q\" xlink:href=\"#f\" transform=\"scale(15)\"/><use id=\"s\" xlink:href=\"#f\" transform=\"scale(10.5)\"/></defs><rect x=\"-50%\" y=\"-50%\" width=\"100%\" height=\"100%\" fill=\"#009b3a\"/><path d=\"M-1743 0l1743 1113 1743-1113-1743-1113z\" fill=\"#fedf00\"/><circle r=\"735\" fill=\"#002776\"/><clipPath id=\"g\"><circle r=\"735\"/></clipPath><path d=\"M-2205 1470a1785 1785 0 0 1 3570 0h-105a1680 1680 0 1 0-3360 0z\" clip-path=\"url(#g)\" fill=\"#fff\"/><g fill=\"#009b3a\" transform=\"translate(-420 1470)\"><use xlink:href=\"#a\" y=\"-1697.5\" transform=\"rotate(-7)\"/><use xlink:href=\"#h\" y=\"-1697.5\" transform=\"rotate(-4)\"/><use xlink:href=\"#i\" y=\"-1697.5\" transform=\"rotate(-1)\"/><use xlink:href=\"#j\" y=\"-1697.5\" transform=\"rotate(2)\"/><use xlink:href=\"#k\" y=\"-1697.5\" transform=\"rotate(5)\"/><use xlink:href=\"#l\" y=\"-1697.5\" transform=\"rotate(9.75)\"/><use xlink:href=\"#c\" y=\"-1697.5\" transform=\"rotate(14.5)\"/><use xlink:href=\"#h\" y=\"-1697.5\" transform=\"rotate(17.5)\"/><use xlink:href=\"#a\" y=\"-1697.5\" transform=\"rotate(20.5)\"/><use xlink:href=\"#m\" y=\"-1697.5\" transform=\"rotate(23.5)\"/><use xlink:href=\"#h\" y=\"-1697.5\" transform=\"rotate(26.5)\"/><use xlink:href=\"#j\" y=\"-1697.5\" transform=\"rotate(29.5)\"/><use xlink:href=\"#n\" y=\"-1697.5\" transform=\"rotate(32.5)\"/><use xlink:href=\"#n\" y=\"-1697.5\" transform=\"rotate(35.5)\"/><use xlink:href=\"#a\" y=\"-1697.5\" transform=\"rotate(38.5)\"/></g><use xlink:href=\"#o\" x=\"-600\" y=\"-132\"/><use xlink:href=\"#o\" x=\"-535\" y=\"177\"/><use xlink:href=\"#p\" x=\"-625\" y=\"243\"/><use xlink:href=\"#q\" x=\"-463\" y=\"132\"/><use xlink:href=\"#p\" x=\"-382\" y=\"250\"/><use xlink:href=\"#r\" x=\"-404\" y=\"323\"/><use xlink:href=\"#o\" x=\"228\" y=\"-228\"/><use xlink:href=\"#o\" x=\"515\" y=\"258\"/><use xlink:href=\"#r\" x=\"617\" y=\"265\"/><use xlink:href=\"#p\" x=\"545\" y=\"323\"/><use xlink:href=\"#p\" x=\"368\" y=\"477\"/><use xlink:href=\"#r\" x=\"367\" y=\"551\"/><use xlink:href=\"#r\" x=\"441\" y=\"419\"/><use xlink:href=\"#p\" x=\"500\" y=\"382\"/><use xlink:href=\"#r\" x=\"365\" y=\"405\"/><use xlink:href=\"#p\" x=\"-280\" y=\"30\"/><use xlink:href=\"#r\" x=\"200\" y=\"-37\"/><use xlink:href=\"#o\" y=\"330\"/><use xlink:href=\"#p\" x=\"85\" y=\"184\"/><use xlink:href=\"#p\" y=\"118\"/><use xlink:href=\"#r\" x=\"-74\" y=\"184\"/><use xlink:href=\"#q\" x=\"-37\" y=\"235\"/><use xlink:href=\"#p\" x=\"220\" y=\"495\"/><use xlink:href=\"#r\" x=\"283\" y=\"430\"/><use xlink:href=\"#r\" x=\"162\" y=\"412\"/><use xlink:href=\"#o\" x=\"-295\" y=\"390\"/><use xlink:href=\"#s\" y=\"575\"/></svg>\n"
    }
    },
    {
    "id": 11,
    "name": "Germany",
    "image_path": "https://cdn.sportmonks.com/images/countries/png/short/de.png",
    "extra": {
    "continent": "Europe",
    "sub_region": "Western Europe",
    "world_region": "EMEA",
    "fifa": "GER",
    "iso": "DEU",
    "iso2": "DE",
    "longitude": "10.382203102111816",
    "latitude": "51.20246505737305",
    "flag": "<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"1000\" height=\"600\" viewBox=\"0 0 5 3\"><desc>Flag of Germany</desc><path d=\"M0 0h5v3h-5z\"/><path fill=\"#D00\" d=\"M0 1h5v2h-5z\"/><path fill=\"#FFCE00\" d=\"M0 2h5v1h-5z\"/></svg>\n"
    }
    },
    {
    "id": 17,
    "name": "France",
    "image_path": "https://cdn.sportmonks.com/images/countries/png/short/fr.png",
    "extra": {
    "continent": "Europe",
    "sub_region": "Western Europe",
    "world_region": "EMEA",
    "fifa": "FRA",
    "iso": "FRA",
    "iso2": "FR",
    "longitude": "2.3382623195648193",
    "latitude": "46.63727951049805",
    "flag": "<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"900\" height=\"600\"><path fill=\"#ED2939\" d=\"M0 0h900v600h-900z\"/><path fill=\"#fff\" d=\"M0 0h600v600h-600z\"/><path fill=\"#002395\" d=\"M0 0h300v600h-300z\"/></svg>\n"
    }
    },
    {
    "id": 20,
    "name": "Portugal",
    "image_path": "https://cdn.sportmonks.com/images/countries/png/short/pt.png",
    "extra": {
    "continent": "Europe",
    "sub_region": "Southern Europe",
    "world_region": "EMEA",
    "fifa": "POR",
    "iso": "PRT",
    "iso2": "PT",
    "longitude": "-8.009422302246094",
    "latitude": "39.64200973510742",
    "flag": "<svg xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\" width=\"600\" height=\"400\"><path fill=\"#f00\" d=\"M0 0h600v400h-600z\"/><path fill=\"#060\" d=\"M0 0h240v400h-240z\"/><g fill=\"#ff0\" fill-rule=\"evenodd\" stroke=\"#000\" stroke-width=\".573\" stroke-linecap=\"round\" stroke-linejoin=\"round\"><path d=\"M318.24 262.04c-30.21-.91-168.74-87.38-169.69-101.15l7.65-12.757c13.741 19.966 155.36 104.06 169.27 101.08l-7.23 12.823\"/><path d=\"M154.59 146.4c-2.71 7.294 36.149 31.318 82.903 59.754 46.752 28.434 87.065 46.006 90.053 43.486.183-.325 1.47-2.541 1.352-2.523-.56.844-1.923 1.11-4.051.497-12.631-3.643-45.575-18.765-86.374-43.506-40.798-24.743-76.294-47.544-81.811-57.232-.384-.671-.657-1.896-.601-2.849l-.134-.002-1.175 2.053-.161.322h-.001zm164.36 116.04c-.512.93-1.468.96-3.282.761-11.3-1.251-45.589-17.925-86.162-42.213-47.21-28.26-86.2-54.01-81.97-60.74l1.151-2.035.227.071c-3.804 11.405 76.948 57.578 81.702 60.522 46.724 28.947 86.115 45.851 89.601 41.458l-1.268 2.181v-.002zM240.17 169.23c30.237-.239 67.55-4.132 89.023-12.69l-4.627-7.517c-12.692 7.025-50.21 11.644-84.652 12.335-40.736-.375-69.49-4.168-83.897-13.835l-4.367 8.005c26.484 11.207 53.623 13.587 88.52 13.703\"/><path d=\"M330.44 156.71c-.739 1.182-14.743 6.011-35.373 9.575-13.988 2.132-32.234 3.955-55.004 3.978-21.633.02-39.305-1.52-52.684-3.333-21.656-3.396-32.833-8.12-36.965-9.79.395-.786.649-1.337 1.03-2.071 11.895 4.736 23.124 7.592 36.279 9.616 13.291 1.8 30.75 3.362 52.276 3.342 22.664-.023 40.709-1.984 54.616-4.053 21.155-3.412 32.711-7.803 34.334-9.842l1.494 2.579h-.002zm-4.06-7.623c-2.293 1.841-13.718 5.893-33.819 9.103-13.415 1.923-30.472 3.643-52.265 3.664-20.704.02-37.619-1.375-50.485-3.249-20.414-2.666-31.279-7.475-35.196-8.878.39-.674.787-1.342 1.194-2.014 3.048 1.535 13.533 5.791 34.226 8.722 12.72 1.804 29.661 3.148 50.262 3.127 21.69-.022 38.553-1.776 51.883-3.688 20.205-2.78 31.077-7.947 32.728-9.241l1.473 2.451v.002zM140.88 205.66c18.598 10.003 59.905 15.044 98.994 15.391 35.591.056 81.958-5.502 99.297-14.69l-.477-10.012c-5.425 8.477-55.113 16.609-99.206 16.276-44.093-.333-85.038-7.143-98.687-15.959l.079 8.991\"/><path d=\"M340.12 204.22l.001 2.387c-2.606 3.116-18.946 7.825-39.437 11.142-15.595 2.391-35.927 4.194-61.262 4.194-24.069 0-43.263-1.716-58.148-4.001-23.529-3.426-38.579-9.426-41.6-11.217l.013-2.785c9.075 6.033 33.661 10.447 41.917 11.798 14.788 2.27 33.868 3.973 57.817 3.973 25.216 0 45.434-1.791 60.931-4.166 14.701-2.124 35.644-7.646 39.767-11.324h.001zm.01-8.492l.001 2.387c-2.606 3.114-18.946 7.824-39.437 11.14-15.595 2.391-35.927 4.194-61.262 4.194-24.069 0-43.263-1.714-58.148-4.001-23.529-3.425-38.579-9.425-41.6-11.216l.013-2.785c9.075 6.032 33.661 10.447 41.917 11.796 14.788 2.272 33.868 3.976 57.817 3.976 25.216 0 45.434-1.792 60.931-4.169 14.701-2.124 35.644-7.646 39.767-11.324l.001.002zM239.79 260.32c-42.772-.255-79.421-11.659-87.16-13.544l5.643 8.834c13.67 5.75 49.424 14.32 81.927 13.371 32.504-.948 60.91-3.466 80.928-13.211l5.786-9.155c-13.642 6.425-60.068 13.639-87.125 13.705\"/><path d=\"M323.3 253.72c-.85 1.299-1.717 2.582-2.596 3.829-9.442 3.329-24.319 6.824-30.597 7.844-12.824 2.642-32.665 4.594-50.274 4.603-37.89-.555-68.905-7.972-83.496-14.299l-1.177-2.024.192-.304 1.997.774c25.948 9.283 55.091 12.987 82.698 13.652 17.538.062 35.095-2.01 49.292-4.549 21.771-4.362 30.574-7.65 33.275-9.14l.687-.385h-.001zm5.017-8.275l.065.078c-.636 1.073-1.291 2.165-1.962 3.262-5.036 1.8-18.702 5.799-38.659 8.589-13.149 1.791-21.322 3.526-47.479 4.034-49.015-1.247-80.75-10.831-88.289-13.195l-1.117-2.143c28.406 7.415 57.422 12.592 89.408 13.121 23.931-.51 34.112-2.272 47.152-4.05 23.271-3.619 34.996-7.45 38.515-8.556l-.154-.199 2.523-.943-.002.002zM328.83 197.76c.139 28.137-14.26 53.386-25.858 64.525-16.408 15.759-38.163 25.896-63.569 26.363-28.37.521-55.12-17.974-62.295-26.099-14.028-15.885-25.449-36.057-25.815-63.243 1.738-30.709 13.793-52.1 31.268-66.769s40.743-21.813 60.121-21.302c22.358.59 48.475 11.558 66.521 33.332 11.823 14.266 16.943 29.748 19.627 53.193zm-89.186-96.342c54.485 0 99.296 44.338 99.296 98.703 0 54.364-44.811 98.704-99.296 98.704s-98.924-44.339-98.924-98.704 44.439-98.703 98.924-98.703\"/><path d=\"M239.91 101.08c54.534 0 99.011 44.483 99.011 99.022 0 54.538-44.478 99.02-99.011 99.02-54.534 0-99.011-44.481-99.011-99.02s44.478-99.022 99.011-99.022zm-96.832 99.022c0 53.26 43.736 96.842 96.832 96.842 53.097 0 96.833-43.582 96.833-96.842 0-53.262-43.737-96.844-96.833-96.844s-96.832 43.584-96.832 96.844zM239.99 109.31c49.731 0 90.693 40.821 90.693 90.704 0 49.884-40.963 90.703-90.693 90.703s-90.693-40.819-90.693-90.703c0-49.883 40.964-90.704 90.693-90.704zm-88.515 90.703c0 48.685 39.979 88.524 88.515 88.524s88.515-39.839 88.515-88.524c0-48.686-39.978-88.525-88.515-88.525-48.536 0-88.515 39.839-88.515 88.525zM243.98 100.68h-8.485l.01 198.96h8.515zM243.13 99.546h2.16l.018 201.25h-2.162l-.016-201.25zm-8.421.002h2.177l.003 201.25h-2.178v-201.25zM338.99 203.935v-7.355l-5.99-5.58-34-9-49-5-59 3-42 10-8.48 6.28v7.357l21.48-9.637 51-8h49l36 4 25 6zM239.95 184.77c23.383-.043 46.07 2.215 64.065 5.719 18.569 3.712 31.637 8.356 36.105 13.571l-.005 2.582c-5.388-6.49-22.973-11.248-36.518-13.968-17.858-3.474-40.393-5.717-63.647-5.674-24.538.046-47.387 2.37-64.984 5.803-14.12 2.802-32.951 8.368-35.302 13.858v-2.689c1.291-3.8 15.313-9.479 34.984-13.417 17.729-3.457 40.62-5.742 65.302-5.786zm.01-8.492c23.383-.042 46.07 2.217 64.065 5.719 18.569 3.714 31.637 8.356 36.105 13.571l-.005 2.582c-5.388-6.489-22.973-11.247-36.518-13.966-17.858-3.476-40.393-5.718-63.647-5.674-24.538.044-47.276 2.37-64.875 5.801-13.626 2.583-33.226 8.37-35.412 13.86v-2.691c1.291-3.759 15.597-9.641 34.985-13.417 17.729-3.457 40.62-5.74 65.302-5.786zM239.48 132.96c36.849-.184 68.99 5.152 83.695 12.685l5.364 9.279c-12.781-6.888-47.456-14.05-89.005-12.979-33.854.208-70.027 3.727-88.176 13.41l6.404-10.709c14.895-7.724 50.022-11.643 81.72-11.684\"/><path d=\"M239.97 140.62c21.017-.056 41.325 1.13 57.476 4.044 15.041 2.799 29.385 7.001 31.436 9.26l1.59 2.81c-4.988-3.257-17.401-6.884-33.339-9.906-16.006-3.008-36.3-4.005-57.2-3.95-23.722-.081-42.152 1.171-57.969 3.929-16.728 3.13-28.334 7.601-31.197 9.726l1.558-2.97c5.563-2.838 14.39-6.259 29.223-8.93 16.357-2.988 34.983-3.884 58.423-4.013h-.001zm-.009-8.484c20.113-.053 39.972 1.068 55.452 3.851 12.209 2.377 24.283 6.087 28.704 9.389l2.326 3.695c-3.954-4.395-18.836-8.559-31.974-10.892-15.361-2.649-34.395-3.698-54.508-3.866-21.108.059-40.615 1.352-55.752 4.108-14.441 2.748-23.76 6.002-27.703 8.543l2.045-3.087c5.441-2.865 14.232-5.495 25.303-7.646 15.249-2.776 34.876-4.036 56.108-4.095zM289.15 241.26c-18.218-3.401-36.469-3.895-49.217-3.745-61.407.72-81.244 12.609-83.665 16.209l-4.589-7.481c15.634-11.332 49.073-17.687 88.587-17.037 20.518.336 38.224 1.699 53.119 4.583l-4.236 7.473\"/><path d=\"M239.58 236.46c17.082.255 33.849.96 50.033 3.978l-1.172 2.069c-15.031-2.775-31.055-3.837-48.803-3.75-22.663-.177-45.585 1.939-65.541 7.667-6.297 1.752-16.721 5.801-17.784 9.146l-1.166-1.923c.336-1.977 6.636-6.081 18.414-9.39 22.858-6.546 44.239-7.649 66.019-7.799v.002zm.775-8.596c17.698.331 35.975 1.149 53.74 4.668l-1.221 2.154c-16.042-3.185-31.369-4.247-52.415-4.57-22.735.041-46.851 1.663-68.778 8.037-7.079 2.062-19.297 6.52-19.704 10.05l-1.166-2.066c.265-3.206 10.842-7.388 20.358-10.156 22.096-6.424 46.275-8.076 69.186-8.117zM327.58 247.38l-7.379 11.449-21.201-18.829-55-37-62-34-32.19-11.01 6.86-12.72 2.33-1.27 20 5 66 34 38 24 32 23 13 15zM148.65 158.29c5.646-3.829 47.139 14.655 90.555 40.834 43.301 26.254 84.677 55.921 80.942 61.473l-1.228 1.932-.564.445c.121-.086.743-.848-.061-2.906-1.845-6.07-31.195-29.491-79.894-58.895-47.475-28.309-87.041-45.371-90.997-40.494l1.247-2.389h-.001zm180.44 88.927c3.57-7.052-34.916-36.044-82.632-64.272-48.813-27.666-83.994-43.951-90.42-39.095l-1.428 2.599c-.012.143.052-.177.354-.41 1.169-1.02 3.105-.951 3.979-.967 11.065.166 42.667 14.709 87.006 40.128 19.428 11.315 82.071 51.491 81.832 62.789.017.971.08 1.171-.285 1.652l1.594-2.424v-.002z\"/></g><path fill=\"#fff\" stroke=\"#000\" stroke-width=\".67\" d=\"M180.6 211.01c0 16.271 6.663 30.987 17.457 41.742 10.815 10.778 25.512 17.579 41.809 17.579 16.381 0 31.247-6.652 42.016-17.389 10.769-10.735 17.443-25.552 17.446-41.88h-.002v-79.189l-118.74-.141.012 79.278h.002z\"/><path fill=\"#f00\" stroke=\"#000\" stroke-width=\".507\" d=\"M182.82 211.12v.045c0 15.557 6.441 29.724 16.775 40.009 10.354 10.305 24.614 16.712 40.214 16.712 15.681 0 29.912-6.361 40.222-16.626 10.308-10.265 16.697-24.433 16.699-40.044h-.002v-76.826l-113.84-.018-.07 76.748m91.022-53.747l.004 48.891-.041 5.172h.001c0 1.361-.082 2.912-.241 4.233-.925 7.729-4.48 14.467-9.745 19.708-6.164 6.136-14.671 9.941-24.047 9.941-9.327 0-17.639-3.938-23.829-10.1-6.35-6.32-10.03-14.986-10.03-23.947l-.013-54.023 67.94.123.002.002z\"/><g id=\"e\"><g id=\"d\" fill=\"#ff0\" stroke=\"#000\" stroke-width=\".5\"><path stroke=\"none\" d=\"M190.19 154.43c.135-5.521 4.052-6.828 4.081-6.847.028-.018 4.231 1.408 4.217 6.899l-8.298-.051\"/><path d=\"M186.81 147.69l-.682 6.345 4.141.009c.04-5.249 3.974-6.122 4.069-6.103.089-.005 3.989 1.161 4.093 6.103h4.151l-.75-6.393-15.022.038v.002zM185.85 154.06h16.946c.357 0 .649.353.649.784 0 .43-.292.781-.649.781h-16.946c-.357 0-.649-.351-.649-.781 0-.431.292-.784.649-.784zM192.01 154.03c.018-3.313 2.262-4.25 2.274-4.248.001 0 2.342.967 2.361 4.248h-4.634\"/><path d=\"M186.21 145.05h16.245c.342 0 .623.318.623.705 0 .387-.28.705-.623.705h-16.245c-.342 0-.623-.316-.623-.705 0-.386.28-.705.623-.705zM186.55 146.47h15.538c.327 0 .595.317.595.704 0 .388-.268.705-.595.705h-15.538c-.327 0-.595-.317-.595-.705 0-.387.268-.704.595-.704zM191.57 135.88l1.227.002v.871h.895v-.891l1.257.004v.887h.898v-.891h1.258l-.002 2.012c0 .316-.254.52-.549.52h-4.411c-.296 0-.57-.237-.571-.527l-.003-1.988h.001zM196.19 138.57l.277 6.451-4.303-.016.285-6.452 3.741.017\"/><path id=\"a\" d=\"M190.94 141.56l.131 3.478-4.126.002.116-3.479h3.879-.001z\"/><use xlink:href=\"#a\" x=\"10.609\"/><path id=\"b\" d=\"M186.3 139.04l1.199.003v.872h.877v-.893l1.229.004v.889h.879v-.893l1.23.002-.002 2.012c0 .314-.249.519-.536.519h-4.317c-.289 0-.558-.235-.559-.526l-.003-1.989h.001z\"/><use xlink:href=\"#b\" x=\"10.609\"/><path fill=\"#000\" stroke=\"none\" d=\"M193.9 140.61c-.026-.627.877-.634.866 0v1.536h-.866v-1.536\"/><path id=\"c\" fill=\"#000\" stroke=\"none\" d=\"M188.57 142.84c-.003-.606.837-.618.826 0v1.187h-.826v-1.187\"/><use xlink:href=\"#c\" x=\"10.641\"/></g><use xlink:href=\"#d\" y=\"46.32\"/><use xlink:href=\"#d\" transform=\"matrix(.705 -.71 .71 .705 -35.341 275.109)\"/></g><use xlink:href=\"#d\" x=\"45.714\"/><use xlink:href=\"#e\" transform=\"matrix(-1 0 0 1 479.792 0)\"/><g id=\"f\" fill=\"#fff\"><path fill=\"#039\" d=\"M232.636 202.406v.005c0 2.212.849 4.227 2.212 5.689 1.365 1.467 3.245 2.378 5.302 2.378 2.067 0 3.944-.905 5.303-2.365 1.358-1.459 2.202-3.472 2.202-5.693v-10.768l-14.992-.012-.027 10.766\"/><circle cx=\"236.074\" cy=\"195.735\" r=\"1.486\"/><circle cx=\"244.392\" cy=\"195.742\" r=\"1.486\"/><circle cx=\"240.225\" cy=\"199.735\" r=\"1.486\"/><circle cx=\"236.074\" cy=\"203.916\" r=\"1.486\"/><circle cx=\"244.383\" cy=\"203.905\" r=\"1.486\"/></g><use xlink:href=\"#f\" y=\"-26.016\"/><use xlink:href=\"#f\" x=\"-20.799\"/><use xlink:href=\"#f\" x=\"20.745\"/><use xlink:href=\"#f\" y=\"25.784\"/></svg>\n"
    }
    },
    {
    "id": 23,
    "name": "Côte d'Ivoire",
    "image_path": "https://cdn.sportmonks.com/images/countries/png/short/ci.png",
    "extra": {
    "continent": "Africa",
    "sub_region": "Western Africa",
    "world_region": "EMEA",
    "fifa": "CIV",
    "iso": "CIV",
    "iso2": "CI",
    "longitude": "-5.552574634552002",
    "latitude": "7.598755359649658",
    "flag": "<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"450\" height=\"300\"><path fill=\"#fff\" d=\"M0 0h450v300h-450z\"/><path fill=\"#f77f00\" d=\"M0 0h150v300h-150z\"/><path fill=\"#009e60\" d=\"M300 0h150v300h-150z\"/></svg>\n"
    }
    },

    NO

    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.

    hashtag
    Example response

    https://soccer.sportmonks.com/api/v2.0/fixtures/deleted?api_token={API_TOKEN}{
      "data": [
        {
          "id
    

    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

    circle-info

    Check this endpoint in Postman. arrow-up-right

    Endpoint details

    Authorization

    API Key

    Pagination

    Authentication
  • Your first request

  • Get your football data

  • What can you do with the data?

  • Different plans and data features

  • hashtag
    What is Football API 2.0?

    Build creative football-related apps with our Football API 2.0arrow-up-right. Football API 2.0 is a REST APIarrow-up-right that can be used to request football data from our expansive database and has the following characteristics:

    • Highly customizable requests

    • Incredibly fast livescores

    • Reliable and accurate data

    circle-info

    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. arrow-up-right

    hashtag
    Authentication

    To make our first request, we’ll need a way to get authenticated first. Football API 2.0 arrow-up-rightutilizes API tokens for the authentication of requests. You can obtain your free API token and manage your API tokens Mysportmonks.arrow-up-right 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).

    Example API token: [HdoiD312ND….]

    The API token is only meant for your eyes and, as such, should be stored away safely.

    circle-info

    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

    hashtag
    Your first request

    Now that all prerequisites have been fulfilled, we’re ready to send our first request to the API!

    hashtag
    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

    An example of a correctly authenticated request would be:

    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

    This request will return all of the leagues eligible for our free planarrow-up-right, 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.

    hashtag
    What can you do with the data?

    The example above was the most basic request you can create, while our highly flexible football api 2.0arrow-up-right can handle way more advanced requests.

    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.

    hashtag
    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

    • Node JS Wrapper: https://github.com/marchitos/sportmonksarrow-up-right

    • PHP Wrapper: https://github.com/joesaunderson/sportmonks-soccerarrow-up-right

    • Laravel PHP Wrapper: https://github.com/kirill-latish/laravel-sportmonks-soccerarrow-up-right

    • Composer PHP Wrapper:

    • Phyton Wrappers:

    • Java Wrappers:

    • Ruby Wrappers:

    • GO Wrapper:

    • Elixir Wrapper:

    • R Wrapper:

    • Golang:

    hashtag
    Different plans and data features

    Sportmonks has various different plansarrow-up-right and data features for you. You can learn all about it in the matrix below. In Mysportmonksarrow-up-right you can choose your ideal plan and data features.

    https://soccer.sportmonks.com/api/v2.0/fixtures/deleted
    https://soccer.sportmonks.com/api/v2.0/
    https://soccer.sportmonks.com/api/v2.0/leagues?api_token={API_TOKEN}
    "data": [
            {
                "id": 271,
                "active": true,
                "type": "domestic",
                "legacy_id": 43,
                "country_id": 320,
                "logo_path": "https://cdn.sportmonks.com/images/soccer/leagues/271.png",
                "name": "Superliga",
                "is_cup": false,
                "current_season_id": 17328,
                "current_round_id": 199450,
                "current_stage_id": 77447994,
                "live_standings": true,
                "coverage": {
                    "predictions": true,
                    "topscorer_goals": true,
                    "topscorer_assists": true,
                    "topscorer_cards": true
                }
    Run in Postman
    Run in Postman

    http://www.github.com/calestini/sportmonks_apiarrow-up-right

    500

    Internal error with our servers

    Indicates what kind of league this is. Possible values: 'domestic', 'cup', 'international'. More values can be found here

    legacy_id

    This was for our API version 1.0. It's only of use for old users of our API

    country_id

    The unique country id the league is played in

    logo_path

    The logo URL path of the league

    name

    The name of the league

    is_cup

    Indicates if the league is a cup or not. Possible values are 'true' or 'false'

    current_season_id

    The unique id of the current season

    current_round_id

    The unique id of the current round

    current_stage_id

    The unique id of the current stage

    live_standings

    Indicates if the league covers live standings

    coverage

    Opens an array of partial coverage for the league

    predictions

    Indicates if the league covers predictions

    topscorers_goals

    Indicates if the league covers goal topscorers

    topscorers_assists

    Indicates if the league covers assists topscorers

    topscorers_cards

    Indicates if the league covers cards topscorers

    https://github.com/hristonev/sportmonks-client-bundlearrow-up-right
    https://github.com/tvl/python-sportmonkarrow-up-right
    https://github.com/Dmitrii-I/sportmonksarrow-up-right
    https://github.com/kevinsamyn/sportmonks-soccerarrow-up-right
    https://github.com/kete1987/sportmonksarrow-up-right
    https://github.com/valdemarua/sportmonks-rubyarrow-up-right
    https://github.com/vnnoder/sportmonks-rubyarrow-up-right
    https://github.com/BialkowskiSz/go-sportmonksarrow-up-right
    https://github.com/vnnoder/ex_sportmonksarrow-up-right
    https://github.com/systats/sportmonksarrow-up-right
    https://github.com/statistico/statistico-sportmonks-go-clientarrow-up-right
    "
    :
    18546759
    ,
    "league_id": 2451,
    "season_id": 19259,
    "time": {
    "status": "Deleted",
    "starting_at": {
    "date_time": "2022-07-02 13:00:00",
    "date": "2022-07-02",
    "time": "13:00:00",
    "timestamp": 1656766800,
    "timezone": "UTC"
    }
    },
    "deleted": true,
    "updated_at": "2022-07-12T14:55:07.000000Z"
    },
    {
    "id": 18546749,
    "league_id": 2451,
    "season_id": 19259,
    "time": {
    "status": "Deleted",
    "starting_at": {
    "date_time": "2022-07-02 12:00:00",
    "date": "2022-07-02",
    "time": "12:00:00",
    "timestamp": 1656763200,
    "timezone": "UTC"
    }
    },
    "deleted": true,
    "updated_at": "2022-07-12T22:03:10.000000Z"
    },
    {
    "id": 18546739,
    "league_id": 2451,
    "season_id": 19259,
    "time": {
    "status": "Deleted",
    "starting_at": {
    "date_time": "2022-07-02 08:30:00",
    "date": "2022-07-02",
    "time": "08:30:00",
    "timestamp": 1656750600,
    "timezone": "UTC"
    }
    },
    "deleted": true,
    "updated_at": "2022-07-13T10:21:06.000000Z"
    },

    The unique id of the season the fixture belongs to

    stage_id

    The unique id of the stage the fixture belongs to

    round_id

    The unique id of the round the fixture belongs to

    group_id

    The unique id of the group the fixture belongs to

    aggregate_id

    Indicates if the fixture has an aggregated score

    venue_id

    The unique id of the venue the fixture is played at

    referee_id

    The unique id of the referee that is in charge of the fixture

    localteam_id

    The unique id of the local team

    visitorteam_id

    The unique id of the visitor team

    winnerteam_id

    Contains the id of the team that won the fixture

    weather_report

    Opens an array of weather details. Possible values of the data in this array can be found in our statuses and definitions

    commentaries

    Indicates if this fixture has commentaries available

    attendance

    Give information about the visitor attendance of the fixture

    pitch

    Gives information about the pitch. Possible values can be found in our statuses and definitions

    details

    Optional additional information.

    neutral_venue

    Indicates if the fixture was played at a neutral fixture. This often happens in cup finals

    formations

    Opens an array containing the lineup formations of the teams. Possible values can be found in our statuses and definitions

    scores

    Opens an array containing the scores of the fixture

    localteam_score

    The number of goals the local team has scored in this fixture

    visitorteam_score

    The number of goals the visitor team has scored in this fixture

    localteam_pen_score

    The number of penalty goals the local team has scored in this fixture (only available when the fixture goes into penalty shootout)

    visitorteam_pen_score

    The number of penalty goals the visitor team has scored in this fixture (only available when the fixture goes into penalty shootout)

    ht_score

    The score at halftime

    ft_score

    The score at full time (90 minutes)

    et_score

    The score in extra time (only available when the fixture goes into extra time)

    ps_score

    The score of the penalty shootout (only available when the fixture goes into penalty shootout)

    time

    Opens an array containing the time details of the fixture

    status

    Indicates in which phase the fixture is in. Possible values can be found in our statuses and definitions

    starting_at

    Opens an array containing the time details of the fixture

    date_time

    Gives the date and time the fixture starts

    date

    Gives the date on which the fixture is played

    time

    Gives the starting time of the fixture

    timestamp

    The timestamp notation of the match

    timezone

    Indicates in which timezone you've requested the data

    minute

    Indicates in which minute the fixture is in

    second

    Indicates in which second the fixture is in

    added_time

    Indicates how much added time is added

    extra_minute

    Extra minute is when a fixture goes to extra time. Extra_minute will count from 0 to 15 and from 15 to 30.

    injury_time

    In case of added time, it will end up in injury_minute

    coaches

    Opens an array containing the unique id's of the coaches

    localteam_coach_id

    The unique id of the coach from the local team

    visitorteam_coach_id

    The unique id of the coach from the visitor team

    standings

    Opens an array containing the standings of the local- and visitor team

    localteam_position

    Indicates in which positions the local team is before the fixture

    visitorteam_position

    Indicates in which positions the visitor team is before the fixture

    assistants

    Opens an array containing the unique id's of the assistant referees

    first_assistant_id

    The unique id of the first assistant

    second_assistant_id

    The unique id of the second assistant

    fourth_official_id

    The unique id of the fourth official

    leg

    Indicates in how many legs this fixture is played

    colors

    Opens an array containing information about the team colors

    localteam

    Opens an array containing information about the local team colors

    color

    The main color code of the local team

    kit_colors

    The kit color codes of the local team

    visitorteam

    Opens an array containing information about the visitor team colors

    color

    The main color code of the visitor team

    kit_colors

    The kit color codes of the local team

    deleted

    Indicates if the team was deleted. More information: Keep in Sync

    is_placeholder

    This property indicates if the resource is used to display dummy data. The false of this property will always be a boolean value.

    GET All In play Livescores

    hashtag
    GET All Inplay Livescores

    Run in Postman

    YES

    Allowed nested includes

    10

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

    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.

    hashtag
    Include options

    localTeam visitorTeam substitutions goals cards other events corners lineup bench sidelined comments tvstations highlights round stage referee venue odds inplayOdds flatOdds localCoach visitorCoach group trends stats probability valuebet news

    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:

    hashtag
    Example response

    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

    circle-info

    Check this endpoint in Postman. arrow-up-right

    Endpoint details

    Authorization

    API Key

    Pagination

    Includeschevron-right
    Run in Postman

    GET All Livescores

    hashtag
    GET All Livescores

    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,

    hashtag
    GET Last Updated Fixtures

    GET Head 2 Head by Team IDs

    hashtag
    Get Head2Head by Team IDs

    https://soccer.sportmonks.com/api/v2.0/livescores/now&api_token={API_TOKEN}
    "data": [
         {
                "id": 18235436,
                "league_id": 1525,
                "season_id": 18607,
                "stage_id": 77454430,
                "round_id": 253354,
                "group_id": null,
                "aggregate_id": null,
                "venue_id": 8805,
                "referee_id": null,
                "localteam_id": 12894,
                "visitorteam_id": 4000,
                "winner_team_id": null,
                "weather_report": {
                    "code": "clouds",
                    "type": "broken clouds",
                    "icon": "https://cdn.sportmonks.com/images/weather/04d.png",
                    "temperature": {
                        "temp": 82.04,
                        "unit": "fahrenheit"
                    },
                    "temperature_celcius": {
                        "temp": 27.8,
                        "unit": "celcius"
                    },
                    "clouds": "66%",
                    "humidity": "37%",
                    "pressure": 1013,
                    "wind": {
                        "speed": "5.23 m/s",
                        "degree": 1
                    },
                    "coordinates": {
                        "lat": 51.203,
                        "lon": 58.3266
                    },
                    "updated_at": "2021-08-04T15:00:15.873956Z"
                },
                "commentaries": false,
                "attendance": null,
                "pitch": null,
                "details": null,
                "neutral_venue": false,
                "winning_odds_calculated": false,
                "formations": {
                    "localteam_formation": null,
                    "visitorteam_formation": null
                },
                "scores": {
                    "localteam_score": 0,
                    "visitorteam_score": 0,
                    "localteam_pen_score": null,
                    "visitorteam_pen_score": null,
                    "ht_score": "0-0",
                    "ft_score": null,
                    "et_score": null,
                    "ps_score": null
                },
                "time": {
                    "status": "LIVE",
                    "starting_at": {
                        "date_time": "2021-08-04 13:00:00",
                        "date": "2021-08-04",
                        "time": "13:00:00",
                        "timestamp": 1628082000,
                        "timezone": "UTC"
                    },
                    "minute": 52,
                    "second": "04",
                    "added_time": null,
                    "extra_minute": null,
                    "injury_time": null
                },
                "coaches": {
                    "localteam_coach_id": 37265768,
                    "visitorteam_coach_id": 470829
                },
                "standings": {
                    "localteam_position": 13,
                    "visitorteam_position": 10
                },
                "assistants": {
                    "first_assistant_id": null,
                    "second_assistant_id": null,
                    "fourth_official_id": null
                },
                "leg": "1/1",
                "colors": {
                    "localteam": {
                        "color": "#C40010",
                        "kit_colors": "#C40010,#C40010,#C40010,#00C1BA,#C40010,#0046A8,#C40010"
                    },
                    "visitorteam": {
                        "color": "#F0F0F0",
                        "kit_colors": "#F0F0F0,#F0F0F0,#0A0A0A,#0A0A0A,#C40010,#0046A8,#022857"
                    }
                },
                "deleted": false,
                "is_placeholder": false
            },
    https://soccer.sportmonks.com/api/v2.0/livescores/now

    YES

    Allowed nested includes

    10

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

    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.

    hashtag
    Include options

    localTeam visitorTeam substitutions goals cards other events corners lineup bench sidelined comments tvstations highlights round stage referee venue odds inplayOdds flatOdds localCoach visitorCoach group trends stats probability valuebet news

    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:

    hashtag
    Example response

    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

    circle-info

    Check this endpoint in Postman. arrow-up-right

    Endpoint details

    Authorization

    API Key

    Pagination

    Includeschevron-right

    Pagination

    YES

    Allowed nested includes

    3

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

    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.

    hashtag
    Include options

    localTeam visitorTeam substitutions goals cards other events corners lineup bench sidelined comments tvstations highlights round stage referee venue odds inplayOdds flatOdds localCoach visitorCoach group trends stats news

    Includes are the cornerstone of our API and allow you to enrich and customize your requests. This flexibility is what distinguishes us from our competitors.

    You can learn more about what includes are and how they work here:

    hashtag
    Example response

    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

    circle-info

    Check this endpoint in Postman. arrow-up-right

    Endpoint details

    Authorization

    API Key

    Includeschevron-right

    NO

    Allowed nested includes

    2

    hashtag
    Parameters

    Available parameters

    include

    Enrich the API with more data and/or nested includes. Can be used by adding &include= to your request url.

    between

    You can filter between dates: &between= This gives you the opportunity to retrieve all past (or future) matches between two teams.

    hashtag
    Include options

    localTeam visitorTeam substitutions goals cards other events corners lineup bench sidelined comments tvstations highlights round stage referee venue odds inplayOdds flatOdds localCoach visitorCoach group trends

    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:

    hashtag
    Example Response

    https://soccer.sportmonks.com/api/v2.0/head2head/338/53?api_token={API_TOKEN}

     "data": [
            {
                "id
    

    Field

    Description

    data

    Opens an array of data you've requested

    id

    A unique fixture id

    league_id

    circle-info

    Check this endpoint in Postman. arrow-up-right

    Endpoint details

    Authorization

    API Key

    Pagination

    Includeschevron-right

    leagues

    Filter on a list of league id's separated by comma. Can be used by adding &leagues= etc to your request url.

    The unique id of the season the fixture belongs to

    stage_id

    The unique id of the stage the fixture belongs to

    round_id

    The unique id of the round the fixture belongs to

    group_id

    The unique id of the group the fixture belongs to

    aggregate_id

    Indicates if the fixture has an aggregated score

    venue_id

    The unique id of the venue the fixture is played at

    referee_id

    The unique id of the referee that is in charge of the fixture

    localteam_id

    The unique id of the local team

    visitorteam_id

    The unique id of the visitor team

    winnerteam_id

    Contains the id of the team that won the fixture

    weather_report

    Opens an array of weather details. Possible values of the data in this array can be found in our statuses and definitions

    commentaries

    Indicates if this fixture has commentaries available

    attendance

    Give information about the visitor attendance of the fixture

    pitch

    Gives information about the pitch. Possible values can be found in our statuses and definitions

    details

    Optional additional information.

    neutral_venue

    Indicates if the fixture was played at a neutral fixture. This often happens in cup finals

    formations

    Opens an array containing the lineup formations of the teams. Possible values can be found in our statuses and definitions

    scores

    Opens an array containing the scores of the fixture

    localteam_score

    The number of goals the local team has scored in this fixture

    visitorteam_score

    The number of goals the visitor team has scored in this fixture

    localteam_pen_score

    The number of penalty goals the local team has scored in this fixture (only available when the fixture goes into penalty shootout)

    visitorteam_pen_score

    The number of penalty goals the visitor team has scored in this fixture (only available when the fixture goes into penalty shootout)

    ht_score

    The score at halftime

    ft_score

    The score at full time (90 minutes)

    et_score

    The score in extra time (only available when the fixture goes into extra time)

    ps_score

    The score of the penalty shootout (only available when the fixture goes into penalty shootout)

    time

    Opens an array containing the time details of the fixture

    status

    Indicates in which phase the fixture is in. Possible values can be found in our statuses and definitions

    starting_at

    Opens an array containing the time details of the fixture

    date_time

    Gives the date and time the fixture starts

    date

    Gives the date on which the fixture is played

    time

    Gives the starting time of the fixture

    timestamp

    The timestamp notation of the match

    timezone

    Indicates in which timezone you've requested the data

    minute

    Indicates in which minute the fixture is in

    second

    Indicates in which second the fixture is in

    added_time

    Indicates how much added time is added

    extra_minute

    Extra minute is when a fixture goes to extra time. Extra_minute will count from 0 to 15 and from 15 to 30.

    injury_time

    In case of added time, it will end up in injury_minute

    coaches

    Opens an array containing the unique id's of the coaches

    localteam_coach_id

    The unique id of the coach from the local team

    visitorteam_coach_id

    The unique id of the coach from the visitor team

    standings

    Opens an array containing the standings of the local- and visitor team

    localteam_position

    Indicates in which positions the local team is before the fixture

    visitorteam_position

    Indicates in which positions the visitor team is before the fixture

    assistants

    Opens an array containing the unique id's of the assistant referees

    first_assistant_id

    The unique id of the first assistant

    second_assistant_id

    The unique id of the second assistant

    fourth_official_id

    The unique id of the fourth official

    leg

    Indicates in how many legs this fixture is played

    colors

    Opens an array containing information about the team colors

    localteam

    Opens an array containing information about the local team colors

    color

    The main color code of the local team

    kit_colors

    The kit color codes of the local team

    visitorteam

    Opens an array containing information about the visitor team colors

    color

    The main color code of the visitor team

    kit_colors

    The kit color codes of the local team

    deleted

    Indicates if the team was deleted. More information: Keep in Sync

    is_placeholder

    This property indicates if the resource is used to display dummy data. The false of this property will always be a boolean value.

    GET Fixtures by Date

    hashtag
    GET Fixtures by Date

    Endpoint details

    Authorization

    API Key

    hashtag
    Parameters

    hashtag
    Include options

    localTeam visitorTeam substitutions goals cards other events corners lineup bench sidelined comments tvstations

    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:

    hashtag
    Example response

    circle-info

    Check this endpoint in Postman.

    GET Fixtures by Date Range for Team

    hashtag
    GET Fixtures by Date Range for Team

    GET Fixtures by Multiple ID's

    hashtag
    GET Fixtures by Multiple ID's

    GET Fixtures by Date Range

    hashtag
    GET Fixtures by Date Range

    GET Fixture by ID

    hashtag
    GET Fixture by ID

    https://soccer.sportmonks.com/api/v2.0/livescores&api_token={API_TOKEN}
        "data": [
            {
                "id": 18219698,
                "league_id": 1963,
                "season_id": 18199,
                "stage_id": 77452905,
                "round_id": 252774,
                "group_id": null,
                "aggregate_id": null,
                "venue_id": 342964,
                "referee_id": null,
                "localteam_id": 250543,
                "visitorteam_id": 250542,
                "winner_team_id": 250543,
                "weather_report": {
                    "code": "clouds",
                    "type": "overcast clouds",
                    "icon": "https://cdn.sportmonks.com/images/weather/04d.png",
                    "temperature": {
                        "temp": 53.8,
                        "unit": "fahrenheit"
                    },
                    "temperature_celcius": {
                        "temp": 12.1,
                        "unit": "celcius"
                    },
                    "clouds": "90%",
                    "humidity": "81%",
                    "pressure": 1008,
                    "wind": {
                        "speed": "10 m/s",
                        "degree": 38
                    },
                    "coordinates": {
                        "lat": -43.5333,
                        "lon": 172.6333
                    },
                    "updated_at": "2021-07-31T23:45:04.789433Z"
                },
                "commentaries": false,
                "attendance": null,
                "pitch": null,
                "details": null,
                "neutral_venue": false,
                "winning_odds_calculated": true,
                "formations": {
                    "localteam_formation": null,
                    "visitorteam_formation": null
                },
                "scores": {
                    "localteam_score": 1,
                    "visitorteam_score": 0,
                    "localteam_pen_score": null,
                    "visitorteam_pen_score": null,
                    "ht_score": null,
                    "ft_score": "1-0",
                    "et_score": null,
                    "ps_score": null
                },
                "time": {
                    "status": "FT",
                    "starting_at": {
                        "date_time": "2021-08-01 00:00:00",
                        "date": "2021-08-01",
                        "time": "00:00:00",
                        "timestamp": 1627776000,
                        "timezone": "UTC"
                    },
                    "minute": 90,
                    "second": null,
                    "added_time": null,
                    "extra_minute": null,
                    "injury_time": null
                },
                "coaches": {
                    "localteam_coach_id": null,
                    "visitorteam_coach_id": null
                },
                "standings": {
                    "localteam_position": 4,
                    "visitorteam_position": 6
                },
                "assistants": {
                    "first_assistant_id": null,
                    "second_assistant_id": null,
                    "fourth_official_id": null
                },
                "leg": "1/1",
                "colors": null,
                "deleted": false,
                "is_placeholder": false
            },
            {
                "id": 18325598,
                "league_id": 1715,
                "season_id": 18765,
                "stage_id": 77454772,
                "round_id": 257110,
                "group_id": 245954,
                "aggregate_id": null,
                "venue_id": null,
                "referee_id": null,
                "localteam_id": 8283,
                "visitorteam_id": 19186,
                "winner_team_id": null,
                "weather_report": null,
                "commentaries": false,
                "attendance": null,
                "pitch": null,
                "details": null,
                "neutral_venue": false,
                "winning_odds_calculated": true,
                "formations": {
    https://soccer.sportmonks.com/api/v2.0/livescores
    https://soccer.sportmonks.com/api/v2.0/fixtures/updates?api_token={API_TOKEN}
    "data": [
            {
                "id": 16475287,
                "league_id": 501,
                "season_id": 17141,
                "stage_id": 77447501,
                "round_id": 194968,
                "group_id": null,
                "aggregate_id": null,
                "venue_id": 8909,
                "referee_id": 14859,
                "localteam_id": 53,
                "visitorteam_id": 338,
                "winner_team_id": 53,
                "weather_report": {
                    "code": "clouds",
                    "type": "few clouds",
                    "icon": "https://cdn.sportmonks.com/images/weather/02d.png",
                    "temperature": {
                        "temp": 59.94,
                        "unit": "fahrenheit"
                    },
                    "temperature_celcius": {
                        "temp": 15.5,
                        "unit": "celcius"
                    },
                    "clouds": "20%",
                    "humidity": "67%",
                    "pressure": 1014,
                    "wind": {
                        "speed": "10.29 m/s",
                        "degree": 300
                    },
                    "coordinates": {
                        "lat": 55.87,
                        "lon": -4.26
                    },
                    "updated_at": "2020-08-02T17:15:04.814798Z"
                },
                "commentaries": false,
                "attendance": null,
                "pitch": null,
                "details": null,
                "neutral_venue": false,
                "winning_odds_calculated": true,
                "formations": {
                    "localteam_formation": "4-2-3-1",
                    "visitorteam_formation": "4-4-2"
                },
                "scores": {
                    "localteam_score": 5,
                    "visitorteam_score": 1,
                    "localteam_pen_score": null,
                    "visitorteam_pen_score": null,
                    "ht_score": "2-1",
                    "ft_score": "5-1",
                    "et_score": null,
                    "ps_score": null
                },
                "time": {
                    "status": "FT",
                    "starting_at": {
                        "date_time": "2020-08-02 15:30:00",
                        "date": "2020-08-02",
                        "time": "15:30:00",
                        "timestamp": 1596382200,
                        "timezone": "UTC"
                    },
                    "minute": 90,
                    "second": null,
                    "added_time": null,
                    "extra_minute": null,
                    "injury_time": null
                },
                "coaches": {
                    "localteam_coach_id": 1467946,
                    "visitorteam_coach_id": 30082158
                },
                "standings": {
                    "localteam_position": 1,
                    "visitorteam_position": 12
                },
                "assistants": {
                    "first_assistant_id": 12118,
                    "second_assistant_id": 17249,
                    "fourth_official_id": 15815
                },
                "leg": "1/1",
                "colors": {
                    "localteam": {
                        "color": "#007848",
                        "kit_colors": "#F0F0F0,#139343,#5B0623,#0A0A0A,#5C8FAE,#FFDF1B,#F0F0F0"
                    },
                    "visitorteam": {
                        "color": "#0046A8",
                        "kit_colors": "#0046A8,#0046A8,#0046A8,#0046A8,#C40010,#0046A8,#0046A8"
                    }
                },
                "deleted": false,
                "is_placeholder": false,
            }
        ]
    https://soccer.sportmonks.com/api/v2.0/fixtures/updates
    https://soccer.sportmonks.com/api/v2.0/head2head/{team_ID}/{team_ID}
    https://soccer.sportmonks.com/api/v2.0/fixtures/date/{date}
    Run in Postman

    Filter on a list of league id's separated by comma. Can be used by adding &leagues= etc to your request url.

    status

    Filter fixtures based on a comma separated list of status codes as defined in the Can be used by adding &status= etc to your request url.

    highlights
    round
    stage
    referee
    venue
    odds
    inplayOdds
    flatOdds
    localCoach
    visitorCoach
    group
    trends
    firstAssistant
    secondAssistant
    fourthOfficial
    stats
    shootout
    league
    stats
    probability
    valuebet
    news

    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.

    Pagination

    YES

    Allowed nested includes

    10

    Available parameters

    page

    The number of the page you want to browse. Can be used by adding &page= etc to your request url.

    include

    Enrich the API with more data and/or nested includes. Can be used by adding &include= etc to your request url.

    fixtures

    Filter on a list of fixture id's separated by comma. Can be used by adding &fixtures= etc to your request url.

    bookmakers

    Filter on a list of bookmaker id's separated by comma. Can be used by adding &bookmakers= etc to your request url.

    markets

    Filter on a list of market id's separated by comma. Can be used by adding &markets= etc to your request url.

    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

    Includeschevron-right
    arrow-up-right

    leagues

    The unique id of the season the fixture belongs to

    "
    :
    16475434
    ,
    "league_id": 501,
    "season_id": 17141,
    "stage_id": 77447501,
    "round_id": 194993,
    "group_id": null,
    "aggregate_id": null,
    "venue_id": 8909,
    "referee_id": 17250,
    "localteam_id": 53,
    "visitorteam_id": 338,
    "winner_team_id": 53,
    "weather_report": {
    "code": "clouds",
    "type": "broken clouds",
    "icon": "https://cdn.sportmonks.com/images/weather/04n.png",
    "temperature": {
    "temp": 37.35,
    "unit": "fahrenheit"
    },
    "temperature_celcius": {
    "temp": 3,
    "unit": "celcius"
    },
    "clouds": "75%",
    "humidity": "93%",
    "pressure": 1010,
    "wind": {
    "speed": "11.5 m/s",
    "degree": 70
    },
    "coordinates": {
    "lat": 55.8652,
    "lon": -4.2576
    },
    "updated_at": "2021-01-27T21:30:20.055902Z"
    },
    "commentaries": false,
    "attendance": null,
    "pitch": null,
    "details": null,
    "neutral_venue": false,
    "winning_odds_calculated": true,
    "formations": {
    "localteam_formation": "4-4-2",
    "visitorteam_formation": "3-4-1-2"
    },
    "scores": {
    "localteam_score": 2,
    "visitorteam_score": 0,
    "localteam_pen_score": null,
    "visitorteam_pen_score": null,
    "ht_score": "1-0",
    "ft_score": "2-0",
    "et_score": null,
    "ps_score": null
    },
    "time": {
    "status": "FT",
    "starting_at": {
    "date_time": "2021-01-27 19:45:00",
    "date": "2021-01-27",
    "time": "19:45:00",
    "timestamp": 1611776700,
    "timezone": "UTC"
    },
    "minute": 90,
    "second": null,
    "added_time": null,
    "extra_minute": null,
    "injury_time": null
    },
    "coaches": {
    "localteam_coach_id": 1467946,
    "visitorteam_coach_id": 30082158
    },
    "standings": {
    "localteam_position": 2,
    "visitorteam_position": 12
    },
    "assistants": {
    "first_assistant_id": 14860,
    "second_assistant_id": 18758,
    "fourth_official_id": 15815
    },
    "leg": "1/1",
    "colors": {
    "localteam": {
    "color": "#F0F0F0",
    "kit_colors": "#F0F0F0,#139343,#5B0623,#0A0A0A,#5C8FAE,#FFDF1B,#F0F0F0"
    },
    "visitorteam": {
    "color": "#C40010",
    "kit_colors": "#F0F0F0,#C40010,#5B0623,#0A0A0A,#5C8FAE,#FFDF1B,#F0F0F0"
    }
    },
    "deleted": false,
    "is_placeholder": false
    },

    The unique id of the league the fixture belongs to

    season_id

    The unique id of the season the fixture belongs to

    stage_id

    The unique id of the stage the fixture belongs to

    round_id

    The unique id of the round the fixture belongs to

    group_id

    The unique id of the group the fixture belongs to

    aggregate_id

    Indicates if the fixture has an aggregated score

    venue_id

    The unique id of the venue the fixture is played at

    referee_id

    The unique id of the referee that is in charge of the fixture

    localteam_id

    The unique id of the local team

    visitorteam_id

    The unique id of the visitor team

    winnerteam_id

    Contains the id of the team that won the fixture

    weather_report

    Opens an array of weather details. Possible values of the data in this array can be found in our statuses and definitions

    commentaries

    Indicates if this fixture has commentaries available

    attendance

    Give information about the visitor attendance of the fixture

    pitch

    Gives information about the pitch. Possible values can be found in our statuses and definitions

    details

    Optional additional information.

    neutral_venue

    Indicates if the fixture was played at a neutral fixture. This often happens in cup finals

    formations

    Opens an array containing the lineup formations of the teams. Possible values can be found in our statuses and definitions

    scores

    Opens an array containing the scores of the fixture

    localteam_score

    The number of goals the local team has scored in this fixture

    visitorteam_score

    The number of goals the visitor team has scored in this fixture

    localteam_pen_score

    The number of penalty goals the local team has scored in this fixture (only available when the fixture goes into penalty shootout)

    visitorteam_pen_score

    The number of penalty goals the visitor team has scored in this fixture (only available when the fixture goes into penalty shootout)

    ht_score

    The score at halftime

    ft_score

    The score at full time (90 minutes)

    et_score

    The score in extra time (only available when the fixture goes into extra time)

    ps_score

    The score of the penalty shootout (only available when the fixture goes into penalty shootout)

    time

    Opens an array containing the time details of the fixture

    status

    Indicates in which phase the fixture is in. Possible values can be found in our statuses and definitions

    starting_at

    Opens an array containing the time details of the fixture

    date_time

    Gives the date and time the fixture starts

    date

    Gives the date on which the fixture is played

    time

    Gives the starting time of the fixture

    timestamp

    The timestamp notation of the match

    timezone

    Indicates in which timezone you've requested the data

    minute

    Indicates in which minute the fixture is in

    second

    Indicates in which second the fixture is in

    added_time

    Indicates how much added time is added

    extra_minute

    Extra minute is when a fixture goes to extra time. Extra_minute will count from 0 to 15 and from 15 to 30.

    injury_time

    In case of added time, it will end up in injury_minute

    coaches

    Opens an array containing the unique id's of the coaches

    localteam_coach_id

    The unique id of the coach from the local team

    visitorteam_coach_id

    The unique id of the coach from the visitor team

    standings

    Opens an array containing the standings of the local- and visitor team

    localteam_position

    Indicates in which positions the local team is before the fixture

    visitorteam_position

    Indicates in which positions the visitor team is before the fixture

    assistants

    Opens an array containing the unique id's of the assistant referees

    first_assistant_id

    The unique id of the first assistant

    second_assistant_id

    The unique id of the second assistant

    fourth_official_id

    The unique id of the fourth official

    leg

    Indicates in how many legs this fixture is played

    colors

    Opens an array containing information about the team colors

    localteam

    Opens an array containing information about the local team colors

    color

    The main color code of the local team

    kit_colors

    The kit color codes of the local team

    visitorteam

    Opens an array containing information about the visitor team colors

    color

    The main color code of the visitor team

    kit_colors

    The kit color codes of the local team

    deleted

    Indicates if the team was deleted. More information: Keep in Sync

    is_placeholder

    This property indicates if the resource is used to display dummy data. The false of this property will always be a boolean value.

    YES

    Allowed nested includes

    10

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

    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.

    hashtag
    Include options

    localTeam visitorTeam substitutions goals cards other events corners lineup bench sidelined comments tvstations highlights round stage referee venue odds inplayOdds flatOdds localCoach visitorCoach group trends firstAssistant secondAssistant fourthOfficial stats shootout league stats probability valuebet news

    Includes are the cornerstone of our API and allow you to enrich and customize your requests. This flexibility is what distinguishes us from our competitors.

    You can learn more about what includes are and how they work here:

    hashtag
    Example response

    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

    circle-info

    Check this endpoint in Postman. arrow-up-right

    Endpoint details

    Authorization

    API Key

    Pagination

    Includeschevron-right

    NO

    Allowed nested includes

    10

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

    hashtag
    Include options

    localTeam visitorTeam substitutions goals cards other events corners lineup bench sidelined comments tvstations highlights round stage referee venue odds inplayOdds flatOdds localCoach visitorCoach group trends firstAssistant secondAssistant fourthOfficial stats shootout league stats probability valuebet news

    Includes are the cornerstone of our API and allow you to enrich and customize your requests. This flexibility is what distinguishes us from our competitors.

    You can learn more about what includes are and how they work here:

    hashtag
    Example response

    https://soccer.sportmonks.com/api/v2.0/fixtures/multi/18327319,18201934&api_token={API_TOKEN}
    "data": [
            {
                "id"
    

    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

    circle-info

    Check this endpoint in Postman. arrow-up-right

    Endpoint details

    Authorization

    API Key

    Pagination

    Includeschevron-right

    YES

    Allowed nested includes

    10

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

    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.

    hashtag
    Include options

    localTeam visitorTeam substitutions goals cards other events corners lineup bench sidelined comments tvstations highlights round stage referee venue odds inplayOdds flatOdds localCoach visitorCoach group trends firstAssistant secondAssistant fourthOfficial stats shootout league stats probability valuebet news

    Includes are the cornerstone of our API and allow you to enrich and customize your requests. This flexibility is what distinguishes us from our competitors.

    You can learn more about what includes are and how they work here:

    hashtag
    Example response

    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

    circle-info

    Check this endpoint in Postman. arrow-up-right

    Endpoint details

    Authorization

    API Key

    Pagination

    Includeschevron-right

    NO

    Allowed nested includes

    10

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

    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.

    hashtag
    Include options

    localTeam visitorTeam substitutions goals cards other events corners lineup bench sidelined comments tvstations highlights round stage referee venue odds inplayOdds flatOdds localCoach visitorCoach group trends firstAssistant secondAssistant fourthOfficial stats shootout league stats probability valuebet news

    Includes are the cornerstone of our API and allow you to enrich and customize your requests. This flexibility is what distinguishes us from our competitors.

    You can learn more about what includes are and how they work here:

    hashtag
    Example response

    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

    circle-info

    Check this endpoint in Postman. arrow-up-right

    Endpoint details

    Authorization

    API Key

    Pagination

    Includeschevron-right

    leagues

    Filter on a list of league id's separated by comma. Can be used by adding &leagues= etc to your request url.

    The unique id of the season the fixture belongs to

    stage_id

    The unique id of the stage the fixture belongs to

    round_id

    The unique id of the round the fixture belongs to

    group_id

    The unique id of the group the fixture belongs to

    aggregate_id

    Indicates if the fixture has an aggregated score

    venue_id

    The unique id of the venue the fixture is played at

    referee_id

    The unique id of the referee that is in charge of the fixture

    localteam_id

    The unique id of the local team

    visitorteam_id

    The unique id of the visitor team

    winnerteam_id

    Contains the id of the team that won the fixture

    weather_report

    Opens an array of weather details. Possible values of the data in this array can be found in our statuses and definitions

    commentaries

    Indicates if this fixture has commentaries available

    attendance

    Give information about the visitor attendance of the fixture

    pitch

    Gives information about the pitch. Possible values can be found in our statuses and definitions

    details

    Optional additional information.

    neutral_venue

    Indicates if the fixture was played at a neutral fixture. This often happens in cup finals

    formations

    Opens an array containing the lineup formations of the teams. Possible values can be found in our statuses and definitions

    scores

    Opens an array containing the scores of the fixture

    localteam_score

    The number of goals the local team has scored in this fixture

    visitorteam_score

    The number of goals the visitor team has scored in this fixture

    localteam_pen_score

    The number of penalty goals the local team has scored in this fixture (only available when the fixture goes into penalty shootout)

    visitorteam_pen_score

    The number of penalty goals the visitor team has scored in this fixture (only available when the fixture goes into penalty shootout)

    ht_score

    The score at halftime

    ft_score

    The score at full time (90 minutes)

    et_score

    The score in extra time (only available when the fixture goes into extra time)

    ps_score

    The score of the penalty shootout (only available when the fixture goes into penalty shootout)

    time

    Opens an array containing the time details of the fixture

    status

    Indicates in which phase the fixture is in. Possible values can be found in our statuses and definitions

    starting_at

    Opens an array containing the time details of the fixture

    date_time

    Gives the date and time the fixture starts

    date

    Gives the date on which the fixture is played

    time

    Gives the starting time of the fixture

    timestamp

    The timestamp notation of the match

    timezone

    Indicates in which timezone you've requested the data

    minute

    Indicates in which minute the fixture is in

    second

    Indicates in which second the fixture is in

    added_time

    Indicates how much added time is added

    extra_minute

    Extra minute is when a fixture goes to extra time. Extra_minute will count from 0 to 15 and from 15 to 30.

    injury_time

    In case of added time, it will end up in injury_minute

    coaches

    Opens an array containing the unique id's of the coaches

    localteam_coach_id

    The unique id of the coach from the local team

    visitorteam_coach_id

    The unique id of the coach from the visitor team

    standings

    Opens an array containing the standings of the local- and visitor team

    localteam_position

    Indicates in which positions the local team is before the fixture

    visitorteam_position

    Indicates in which positions the visitor team is before the fixture

    assistants

    Opens an array containing the unique id's of the assistant referees

    first_assistant_id

    The unique id of the first assistant

    second_assistant_id

    The unique id of the second assistant

    fourth_official_id

    The unique id of the fourth official

    leg

    Indicates in how many legs this fixture is played

    colors

    Opens an array containing information about the team colors

    localteam

    Opens an array containing information about the local team colors

    color

    The main color code of the local team

    kit_colors

    The kit color codes of the local team

    visitorteam

    Opens an array containing information about the visitor team colors

    color

    The main color code of the visitor team

    kit_colors

    The kit color codes of the local team

    deleted

    Indicates if the team was deleted. More information: Keep in Sync

    is_placeholder

    This property indicates if the resource is used to display dummy data. The false of this property will always be a boolean value.

    leagues

    Filter on a list of league id's separated by comma. Can be used by adding &leagues= etc to your request url.

    status

    Filter fixtures based on a comma separated list of status codes as defined in the "Statuses & Definitions" documentation page. Can be used by adding &status= etc to your request url.

    timestamp

    Add a unix timestamp to only receive the fixtures that have received an updated after this value.

    The unique id of the season the fixture belongs to

    stage_id

    The unique id of the stage the fixture belongs to

    round_id

    The unique id of the round the fixture belongs to

    group_id

    The unique id of the group the fixture belongs to

    aggregate_id

    Indicates if the fixture has an aggregated score

    venue_id

    The unique id of the venue the fixture is played at

    referee_id

    The unique id of the referee that is in charge of the fixture

    localteam_id

    The unique id of the local team

    visitorteam_id

    The unique id of the visitor team

    winnerteam_id

    Contains the id of the team that won the fixture

    weather_report

    Opens an array of weather details. Possible values of the data in this array can be found in our statuses and definitions

    commentaries

    Indicates if this fixture has commentaries available

    attendance

    Give information about the visitor attendance of the fixture

    pitch

    Gives information about the pitch. Possible values can be found in our statuses and definitions

    details

    Optional additional information.

    neutral_venue

    Indicates if the fixture was played at a neutral fixture. This often happens in cup finals

    formations

    Opens an array containing the lineup formations of the teams. Possible values can be found in our statuses and definitions

    scores

    Opens an array containing the scores of the fixture

    localteam_score

    The number of goals the local team has scored in this fixture

    visitorteam_score

    The number of goals the visitor team has scored in this fixture

    localteam_pen_score

    The number of penalty goals the local team has scored in this fixture (only available when the fixture goes into penalty shootout)

    visitorteam_pen_score

    The number of penalty goals the visitor team has scored in this fixture (only available when the fixture goes into penalty shootout)

    ht_score

    The score at halftime

    ft_score

    The score at full time (90 minutes)

    et_score

    The score in extra time (only available when the fixture goes into extra time)

    ps_score

    The score of the penalty shootout (only available when the fixture goes into penalty shootout)

    time

    Opens an array containing the time details of the fixture

    status

    Indicates in which phase the fixture is in. Possible values can be found in our statuses and definitions

    starting_at

    Opens an array containing the time details of the fixture

    date_time

    Gives the date and time the fixture starts

    date

    Gives the date on which the fixture is played

    time

    Gives the starting time of the fixture

    timestamp

    The timestamp notation of the match

    timezone

    Indicates in which timezone you've requested the data

    minute

    Indicates in which minute the fixture is in

    second

    Indicates in which second the fixture is in

    added_time

    Indicates how much added time is added

    extra_minute

    Extra minute is when a fixture goes to extra time. Extra_minute will count from 0 to 15 and from 15 to 30.

    injury_time

    In case of added time, it will end up in injury_minute

    coaches

    Opens an array containing the unique id's of the coaches

    localteam_coach_id

    The unique id of the coach from the local team

    visitorteam_coach_id

    The unique id of the coach from the visitor team

    standings

    Opens an array containing the standings of the local- and visitor team

    localteam_position

    Indicates in which positions the local team is before the fixture

    visitorteam_position

    Indicates in which positions the visitor team is before the fixture

    assistants

    Opens an array containing the unique id's of the assistant referees

    first_assistant_id

    The unique id of the first assistant

    second_assistant_id

    The unique id of the second assistant

    fourth_official_id

    The unique id of the fourth official

    leg

    Indicates in how many legs this fixture is played

    colors

    Opens an array containing information about the team colors

    localteam

    Opens an array containing information about the local team colors

    color

    The main color code of the local team

    kit_colors

    The kit color codes of the local team

    visitorteam

    Opens an array containing information about the visitor team colors

    color

    The main color code of the visitor team

    kit_colors

    The kit color codes of the local team

    deleted

    Indicates if the team was deleted. More information: Keep in Sync

    is_placeholder

    This property indicates if the resource is used to display dummy data. The false of this property will always be a boolean value.

    https://soccer.sportmonks.com/api/v2.0/fixtures/date/2021-08-04?api_token={API_TOKEN}
    "data": [
            {
                "id": 17893546,
                "league_id": 699,
                "season_id": 18166,
                "stage_id": 77452627,
                "round_id": 239455,
                "group_id": null,
                "aggregate_id": null,
                "venue_id": 5345,
                "referee_id": null,
                "localteam_id": 15341,
                "visitorteam_id": 254167,
                "winner_team_id": 15341,
                "weather_report": {
                    "code": "clouds",
                    "type": "broken clouds",
                    "icon": "https://cdn.sportmonks.com/images/weather/04n.png",
                    "temperature": {
                        "temp": 50.95,
                        "unit": "fahrenheit"
                    },
                    "temperature_celcius": {
                        "temp": 10.5,
                        "unit": "celcius"
                    },
                    "clouds": "57%",
                    "humidity": "68%",
                    "pressure": 1020,
                    "wind": {
                        "speed": "4.72 m/s",
                        "degree": 117
                    },
                    "coordinates": {
                        "lat": -0.2299,
                        "lon": -78.5249
                    },
                    "updated_at": "2021-08-04T01:45:02.268709Z"
                },
                "commentaries": false,
                "attendance": null,
                "pitch": null,
                "details": null,
                "neutral_venue": false,
                "winning_odds_calculated": true,
                "formations": {
                    "localteam_formation": null,
                    "visitorteam_formation": null
                },
                "scores": {
                    "localteam_score": 2,
                    "visitorteam_score": 0,
                    "localteam_pen_score": null,
                    "visitorteam_pen_score": null,
                    "ht_score": "0-0",
                    "ft_score": "2-0",
                    "et_score": null,
                    "ps_score": null
                },
                "time": {
                    "status": "FT",
                    "starting_at": {
                        "date_time": "2021-08-04 00:00:00",
                        "date": "2021-08-04",
                        "time": "00:00:00",
                        "timestamp": 1628035200,
                        "timezone": "UTC"
                    },
                    "minute": 90,
                    "second": null,
                    "added_time": null,
                    "extra_minute": null,
                    "injury_time": null
                },
                "coaches": {
                    "localteam_coach_id": 37437835,
                    "visitorteam_coach_id": null
                },
                "standings": {
                    "localteam_position": 7,
                    "visitorteam_position": 4
                },
                "assistants": {
                    "first_assistant_id": null,
                    "second_assistant_id": null,
                    "fourth_official_id": null
                },
                "leg": "1/1",
                "colors": {
                    "localteam": {
                        "color": "#F0F0F0",
                        "kit_colors": "#F0F0F0,#F0F0F0,#007848,#F0F0F0,#FF0000,#0000FF,#F0F0F0"
                    },
                    "visitorteam": {
                        "color": "#0046A8",
                        "kit_colors": "#F0F0F0,#0046A8,#0046A8,#0046A8,#C40010,#0046A8,#0A0A0A"
                    }
                },
                "deleted": false,
                "is_placeholder": false
            },
    https://soccer.sportmonks.com/api/v2.0/fixtures/between/2021-08-04/2021-09-04/9?api_token={API_TOKEN}
     "data": [
            {
                "id": 18125073,
                "league_id": 23,
                "season_id": 18344,
                "stage_id": null,
                "round_id": null,
                "group_id": null,
                "aggregate_id": null,
                "venue_id": 1315,
                "referee_id": 15294,
                "localteam_id": 42,
                "visitorteam_id": 9,
                "winner_team_id": null,
                "weather_report": null,
                "commentaries": false,
                "attendance": null,
                "pitch": null,
                "details": null,
                "neutral_venue": false,
                "winning_odds_calculated": false,
                "formations": {
                    "localteam_formation": null,
                    "visitorteam_formation": null
                },
                "scores": {
                    "localteam_score": 0,
                    "visitorteam_score": 0,
                    "localteam_pen_score": null,
                    "visitorteam_pen_score": null,
                    "ht_score": null,
                    "ft_score": null,
                    "et_score": null,
                    "ps_score": null
                },
                "time": {
                    "status": "NS",
                    "starting_at": {
                        "date_time": "2021-08-07 16:15:00",
                        "date": "2021-08-07",
                        "time": "16:15:00",
                        "timestamp": 1628352900,
                        "timezone": "UTC"
                    },
                    "minute": null,
                    "second": null,
                    "added_time": null,
                    "extra_minute": null,
                    "injury_time": null
                },
                "coaches": {
                    "localteam_coach_id": 896460,
                    "visitorteam_coach_id": 455361
                },
                "standings": {
                    "localteam_position": 1,
                    "visitorteam_position": 2
                },
                "assistants": {
                    "first_assistant_id": 12090,
                    "second_assistant_id": 12096,
                    "fourth_official_id": 14814
                },
                "leg": "1/1",
                "colors": null,
                "deleted": false,
                "is_placeholder": false
            },
            {
                "id": 18138611,
                "league_id": 8,
                "season_id": 18378,
                "stage_id": 77453700,
                "round_id": 247583,
                "group_id": null,
                "aggregate_id": null,
                "venue_id": 281313,
                "referee_id": null,
                "localteam_id": 6,
                "visitorteam_id": 9,
                "winner_team_id": null,
                "weather_report": null,
                "commentaries": false,
                "attendance": null,
                "pitch": null,
                "details": null,
                "neutral_venue": false,
                "winning_odds_calculated": false,
                "formations": {
                    "localteam_formation": null,
                    "visitorteam_formation": null
                },
                "scores": {
                    "localteam_score": 0,
                    "visitorteam_score": 0,
                    "localteam_pen_score": null,
                    "visitorteam_pen_score": null,
                    "ht_score": null,
                    "ft_score": null,
                    "et_score": null,
                    "ps_score": null
                },
                "time": {
                    "status": "NS",
                    "starting_at": {
                        "date_time": "2021-08-15 15:30:00",
                        "date": "2021-08-15",
                        "time": "15:30:00",
                        "timestamp": 1629041400,
                        "timezone": "UTC"
                    },
                    "minute": null,
                    "second": null,
                    "added_time": null,
                    "extra_minute": null,
                    "injury_time": null
                },
                "coaches": {
                    "localteam_coach_id": null,
                    "visitorteam_coach_id": null
                },
                "standings": {
                    "localteam_position": null,
                    "visitorteam_position": null
                },
                "assistants": {
                    "first_assistant_id": null,
                    "second_assistant_id": null,
                    "fourth_official_id": null
                },
                "leg": "1/1",
                "colors": null,
                "deleted": false,
                "is_placeholder": false
            },
    https://soccer.sportmonks.com/api/v2.0/fixtures/between/{start_date}/{end_date}/{team_ID}
    https://soccer.sportmonks.com/api/v2.0/fixtures/multi/{ID_LIST}
    https://soccer.sportmonks.com/api/v2.0/fixtures/between/2021-08-04/2021-08-11?api_token={API_TOKEN}
       "data": [
            {
                "id": 17893546,
                "league_id": 699,
                "season_id": 18166,
                "stage_id": 77452627,
                "round_id": 239455,
                "group_id": null,
                "aggregate_id": null,
                "venue_id": 5345,
                "referee_id": null,
                "localteam_id": 15341,
                "visitorteam_id": 254167,
                "winner_team_id": 15341,
                "weather_report": {
                    "code": "clouds",
                    "type": "broken clouds",
                    "icon": "https://cdn.sportmonks.com/images/weather/04n.png",
                    "temperature": {
                        "temp": 50.95,
                        "unit": "fahrenheit"
                    },
                    "temperature_celcius": {
                        "temp": 10.5,
                        "unit": "celcius"
                    },
                    "clouds": "57%",
                    "humidity": "68%",
                    "pressure": 1020,
                    "wind": {
                        "speed": "4.72 m/s",
                        "degree": 117
                    },
                    "coordinates": {
                        "lat": -0.2299,
                        "lon": -78.5249
                    },
                    "updated_at": "2021-08-04T01:45:02.268709Z"
                },
                "commentaries": false,
                "attendance": null,
                "pitch": null,
                "details": null,
                "neutral_venue": false,
                "winning_odds_calculated": true,
                "formations": {
                    "localteam_formation": null,
                    "visitorteam_formation": null
                },
                "scores": {
                    "localteam_score": 2,
                    "visitorteam_score": 0,
                    "localteam_pen_score": null,
                    "visitorteam_pen_score": null,
                    "ht_score": "0-0",
                    "ft_score": "2-0",
                    "et_score": null,
                    "ps_score": null
                },
                "time": {
                    "status": "FT",
                    "starting_at": {
                        "date_time": "2021-08-04 00:00:00",
                        "date": "2021-08-04",
                        "time": "00:00:00",
                        "timestamp": 1628035200,
                        "timezone": "UTC"
                    },
                    "minute": 90,
                    "second": null,
                    "added_time": null,
                    "extra_minute": null,
                    "injury_time": null
                },
                "coaches": {
                    "localteam_coach_id": 37437835,
                    "visitorteam_coach_id": null
                },
                "standings": {
                    "localteam_position": 7,
                    "visitorteam_position": 4
                },
                "assistants": {
                    "first_assistant_id": null,
                    "second_assistant_id": null,
                    "fourth_official_id": null
                },
                "leg": "1/1",
                "colors": {
                    "localteam": {
                        "color": "#F0F0F0",
                        "kit_colors": "#F0F0F0,#F0F0F0,#007848,#F0F0F0,#FF0000,#0000FF,#F0F0F0"
                    },
                    "visitorteam": {
                        "color": "#0046A8",
                        "kit_colors": "#F0F0F0,#0046A8,#0046A8,#0046A8,#C40010,#0046A8,#0A0A0A"
                    }
                },
                "deleted": false,
                "is_placeholder": false
            },
    https://soccer.sportmonks.com/api/v2.0/fixtures/between/{start_date}/{end_date}
    https://soccer.sportmonks.com/api/v2.0/fixtures/16475287?api_token={API_TOKEN}
        "data": [
            {
                "id": 16475287,
                "league_id": 501,
                "season_id": 17141,
                "stage_id": 77447501,
                "round_id": 194968,
                "group_id": null,
                "aggregate_id": null,
                "venue_id": 8909,
                "referee_id": 14859,
                "localteam_id": 53,
                "visitorteam_id": 338,
                "winner_team_id": 53,
                "weather_report": {
                    "code": "clouds",
                    "type": "few clouds",
                    "icon": "https://cdn.sportmonks.com/images/weather/02d.png",
                    "temperature": {
                        "temp": 59.94,
                        "unit": "fahrenheit"
                    },
                    "temperature_celcius": {
                        "temp": 15.5,
                        "unit": "celcius"
                    },
                    "clouds": "20%",
                    "humidity": "67%",
                    "pressure": 1014,
                    "wind": {
                        "speed": "10.29 m/s",
                        "degree": 300
                    },
                    "coordinates": {
                        "lat": 55.87,
                        "lon": -4.26
                    },
                    "updated_at": "2020-08-02T17:15:04.814798Z"
                },
                "commentaries": false,
                "attendance": null,
                "pitch": null,
                "details": null,
                "neutral_venue": false,
                "winning_odds_calculated": true,
                "formations": {
                    "localteam_formation": "4-2-3-1",
                    "visitorteam_formation": "4-4-2"
                },
                "scores": {
                    "localteam_score": 5,
                    "visitorteam_score": 1,
                    "localteam_pen_score": null,
                    "visitorteam_pen_score": null,
                    "ht_score": "2-1",
                    "ft_score": "5-1",
                    "et_score": null,
                    "ps_score": null
                },
                "time": {
                    "status": "FT",
                    "starting_at": {
                        "date_time": "2020-08-02 15:30:00",
                        "date": "2020-08-02",
                        "time": "15:30:00",
                        "timestamp": 1596382200,
                        "timezone": "UTC"
                    },
                    "minute": 90,
                    "second": null,
                    "added_time": null,
                    "extra_minute": null,
                    "injury_time": null
                },
                "coaches": {
                    "localteam_coach_id": 1467946,
                    "visitorteam_coach_id": 30082158
                },
                "standings": {
                    "localteam_position": 1,
                    "visitorteam_position": 12
                },
                "assistants": {
                    "first_assistant_id": 12118,
                    "second_assistant_id": 17249,
                    "fourth_official_id": 15815
                },
                "leg": "1/1",
                "colors": {
                    "localteam": {
                        "color": "#007848",
                        "kit_colors": "#F0F0F0,#139343,#5B0623,#0A0A0A,#5C8FAE,#FFDF1B,#F0F0F0"
                    },
                    "visitorteam": {
                        "color": "#0046A8",
                        "kit_colors": "#0046A8,#0046A8,#0046A8,#0046A8,#C40010,#0046A8,#0046A8"
                    }
                },
                "deleted": false,
                "is_placeholder": false,
            }
        ],
    https://soccer.sportmonks.com/api/v2.0/fixtures/{ID}
    Run in Postman
    Run in Postman
    Run in Postman
    "Statuses & Definitions" documentation page.
    statuses and definitions
    statuses and definitions
    statuses and definitions
    statuses and definitions
    Keep in Sync
    Run in Postman
    :
    18201934
    ,
    "league_id": 749,
    "season_id": 18528,
    "stage_id": 77454185,
    "round_id": 251880,
    "group_id": null,
    "aggregate_id": null,
    "venue_id": 9175,
    "referee_id": 65998,
    "localteam_id": 15553,
    "visitorteam_id": 8329,
    "winner_team_id": 8329,
    "weather_report": {
    "code": "clouds",
    "type": "overcast clouds",
    "icon": "https://cdn.sportmonks.com/images/weather/04n.png",
    "temperature": {
    "temp": 66,
    "unit": "fahrenheit"
    },
    "temperature_celcius": {
    "temp": 18.9,
    "unit": "celcius"
    },
    "clouds": "100%",
    "humidity": "88%",
    "pressure": 1016,
    "wind": {
    "speed": "3.67 m/s",
    "degree": 340
    },
    "coordinates": {
    "lat": 17.05,
    "lon": -96.7167
    },
    "updated_at": "2021-08-04T01:45:02.779796Z"
    },
    "commentaries": false,
    "attendance": null,
    "pitch": null,
    "details": null,
    "neutral_venue": false,
    "winning_odds_calculated": true,
    "formations": {
    "localteam_formation": null,
    "visitorteam_formation": null
    },
    "scores": {
    "localteam_score": 0,
    "visitorteam_score": 1,
    "localteam_pen_score": null,
    "visitorteam_pen_score": null,
    "ht_score": "0-1",
    "ft_score": "0-1",
    "et_score": null,
    "ps_score": null
    },
    "time": {
    "status": "FT",
    "starting_at": {
    "date_time": "2021-08-04 00:05:00",
    "date": "2021-08-04",
    "time": "00:05:00",
    "timestamp": 1628035500,
    "timezone": "UTC"
    },
    "minute": 90,
    "second": null,
    "added_time": null,
    "extra_minute": null,
    "injury_time": null
    },
    "coaches": {
    "localteam_coach_id": 36084482,
    "visitorteam_coach_id": 251906
    },
    "standings": {
    "localteam_position": 9,
    "visitorteam_position": 10
    },
    "assistants": {
    "first_assistant_id": 66356,
    "second_assistant_id": 66236,
    "fourth_official_id": 69284
    },
    "leg": "1/1",
    "colors": {
    "localteam": {
    "color": "#002B87",
    "kit_colors": "#002B87,#002B87,#002B87,#002B87,#C40010,#0046A8,#002B87"
    },
    "visitorteam": {
    "color": "#F0F0F0",
    "kit_colors": "#F0F0F0,#F0F0F0,#022857,#022857,#C40010,#0046A8,#F0F0F0"
    }
    },
    "deleted": false,
    "is_placeholder": false
    },
    {
    "id": 18327319,
    "league_id": 1827,
    "season_id": 17041,
    "stage_id": null,
    "round_id": null,
    "group_id": null,
    "aggregate_id": null,
    "venue_id": null,
    "referee_id": null,
    "localteam_id": 252335,
    "visitorteam_id": 251861,
    "winner_team_id": null,
    "weather_report": null,
    "commentaries": false,
    "attendance": null,
    "pitch": null,
    "details": null,
    "neutral_venue": false,
    "winning_odds_calculated": false,
    "formations": {
    "localteam_formation": null,
    "visitorteam_formation": null
    },
    "scores": {
    "localteam_score": 0,
    "visitorteam_score": 0,
    "localteam_pen_score": null,
    "visitorteam_pen_score": null,
    "ht_score": null,
    "ft_score": null,
    "et_score": null,
    "ps_score": null
    },
    "time": {
    "status": "NS",
    "starting_at": {
    "date_time": "2021-08-04 00:00:00",
    "date": "2021-08-04",
    "time": "00:00:00",
    "timestamp": 1628035200,
    "timezone": "UTC"
    },
    "minute": null,
    "second": null,
    "added_time": null,
    "extra_minute": null,
    "injury_time": null
    },
    "coaches": {
    "localteam_coach_id": null,
    "visitorteam_coach_id": null
    },
    "standings": {
    "localteam_position": null,
    "visitorteam_position": null
    },
    "assistants": {
    "first_assistant_id": null,
    "second_assistant_id": null,
    "fourth_official_id": null
    },
    "leg": "1/1",
    "colors": null,
    "deleted": false,
    "is_placeholder": false
    }
    ]

    The unique id of the season the fixture belongs to

    stage_id

    The unique id of the stage the fixture belongs to

    round_id

    The unique id of the round the fixture belongs to

    group_id

    The unique id of the group the fixture belongs to

    aggregate_id

    Indicates if the fixture has an aggregated score

    venue_id

    The unique id of the venue the fixture is played at

    referee_id

    The unique id of the referee that is in charge of the fixture

    localteam_id

    The unique id of the local team

    visitorteam_id

    The unique id of the visitor team

    winnerteam_id

    Contains the id of the team that won the fixture

    weather_report

    Opens an array of weather details. Possible values of the data in this array can be found in our statuses and definitions

    commentaries

    Indicates if this fixture has commentaries available

    attendance

    Give information about the visitor attendance of the fixture

    pitch

    Gives information about the pitch. Possible values can be found in our statuses and definitions

    details

    Optional additional information.

    neutral_venue

    Indicates if the fixture was played at a neutral fixture. This often happens in cup finals

    formations

    Opens an array containing the lineup formations of the teams. Possible values can be found in our statuses and definitions

    scores

    Opens an array containing the scores of the fixture

    localteam_score

    The number of goals the local team has scored in this fixture

    visitorteam_score

    The number of goals the visitor team has scored in this fixture

    localteam_pen_score

    The number of penalty goals the local team has scored in this fixture (only available when the fixture goes into penalty shootout)

    visitorteam_pen_score

    The number of penalty goals the visitor team has scored in this fixture (only available when the fixture goes into penalty shootout)

    ht_score

    The score at halftime

    ft_score

    The score at full time (90 minutes)

    et_score

    The score in extra time (only available when the fixture goes into extra time)

    ps_score

    The score of the penalty shootout (only available when the fixture goes into penalty shootout)

    time

    Opens an array containing the time details of the fixture

    status

    Indicates in which phase the fixture is in. Possible values can be found in our statuses and definitions

    starting_at

    Opens an array containing the time details of the fixture

    date_time

    Gives the date and time the fixture starts

    date

    Gives the date on which the fixture is played

    time

    Gives the starting time of the fixture

    timestamp

    The timestamp notation of the match

    timezone

    Indicates in which timezone you've requested the data

    minute

    Indicates in which minute the fixture is in

    second

    Indicates in which second the fixture is in

    added_time

    Indicates how much added time is added

    extra_minute

    Extra minute is when a fixture goes to extra time. Extra_minute will count from 0 to 15 and from 15 to 30.

    injury_time

    In case of added time, it will end up in injury_minute

    coaches

    Opens an array containing the unique id's of the coaches

    localteam_coach_id

    The unique id of the coach from the local team

    visitorteam_coach_id

    The unique id of the coach from the visitor team

    standings

    Opens an array containing the standings of the local- and visitor team

    localteam_position

    Indicates in which positions the local team is before the fixture

    visitorteam_position

    Indicates in which positions the visitor team is before the fixture

    assistants

    Opens an array containing the unique id's of the assistant referees

    first_assistant_id

    The unique id of the first assistant

    second_assistant_id

    The unique id of the second assistant

    fourth_official_id

    The unique id of the fourth official

    leg

    Indicates in how many legs this fixture is played

    colors

    Opens an array containing information about the team colors

    localteam

    Opens an array containing information about the local team colors

    color

    The main color code of the local team

    kit_colors

    The kit color codes of the local team

    visitorteam

    Opens an array containing information about the visitor team colors

    color

    The main color code of the visitor team

    kit_colors

    The kit color codes of the local team

    deleted

    Indicates if the team was deleted. More information: Keep in Sync

    is_placeholder

    This property indicates if the resource is used to display dummy data. The false of this property will always be a boolean value.

    leagues

    Filter on a list of league id's separated by comma. Can be used by adding &leagues= etc to your request url.

    status

    Filter fixtures based on a comma separated list of status codes as defined in the "Statuses & Definitions" documentation page. Can be used by adding &status= etc to your request url.

    The unique id of the season the fixture belongs to

    stage_id

    The unique id of the stage the fixture belongs to

    round_id

    The unique id of the round the fixture belongs to

    group_id

    The unique id of the group the fixture belongs to

    aggregate_id

    Indicates if the fixture has an aggregated score

    venue_id

    The unique id of the venue the fixture is played at

    referee_id

    The unique id of the referee that is in charge of the fixture

    localteam_id

    The unique id of the local team

    visitorteam_id

    The unique id of the visitor team

    winnerteam_id

    Contains the id of the team that won the fixture

    weather_report

    Opens an array of weather details. Possible values of the data in this array can be found in our statuses and definitions

    commentaries

    Indicates if this fixture has commentaries available

    attendance

    Give information about the visitor attendance of the fixture

    pitch

    Gives information about the pitch. Possible values can be found in our statuses and definitions

    details

    Optional additional information.

    neutral_venue

    Indicates if the fixture was played at a neutral fixture. This often happens in cup finals

    formations

    Opens an array containing the lineup formations of the teams. Possible values can be found in our statuses and definitions

    scores

    Opens an array containing the scores of the fixture

    localteam_score

    The number of goals the local team has scored in this fixture

    visitorteam_score

    The number of goals the visitor team has scored in this fixture

    localteam_pen_score

    The number of penalty goals the local team has scored in this fixture (only available when the fixture goes into penalty shootout)

    visitorteam_pen_score

    The number of penalty goals the visitor team has scored in this fixture (only available when the fixture goes into penalty shootout)

    ht_score

    The score at halftime

    ft_score

    The score at full time (90 minutes)

    et_score

    The score in extra time (only available when the fixture goes into extra time)

    ps_score

    The score of the penalty shootout (only available when the fixture goes into penalty shootout)

    time

    Opens an array containing the time details of the fixture

    status

    Indicates in which phase the fixture is in. Possible values can be found in our statuses and definitions

    starting_at

    Opens an array containing the time details of the fixture

    date_time

    Gives the date and time the fixture starts

    date

    Gives the date on which the fixture is played

    time

    Gives the starting time of the fixture

    timestamp

    The timestamp notation of the match

    timezone

    Indicates in which timezone you've requested the data

    minute

    Indicates in which minute the fixture is in

    second

    Indicates in which second the fixture is in

    added_time

    Indicates how much added time is added

    extra_minute

    Extra minute is when a fixture goes to extra time. Extra_minute will count from 0 to 15 and from 15 to 30.

    injury_time

    In case of added time, it will end up in injury_minute

    coaches

    Opens an array containing the unique id's of the coaches

    localteam_coach_id

    The unique id of the coach from the local team

    visitorteam_coach_id

    The unique id of the coach from the visitor team

    standings

    Opens an array containing the standings of the local- and visitor team

    localteam_position

    Indicates in which positions the local team is before the fixture

    visitorteam_position

    Indicates in which positions the visitor team is before the fixture

    assistants

    Opens an array containing the unique id's of the assistant referees

    first_assistant_id

    The unique id of the first assistant

    second_assistant_id

    The unique id of the second assistant

    fourth_official_id

    The unique id of the fourth official

    leg

    Indicates in how many legs this fixture is played

    colors

    Opens an array containing information about the team colors

    localteam

    Opens an array containing information about the local team colors

    color

    The main color code of the local team

    kit_colors

    The kit color codes of the local team

    visitorteam

    Opens an array containing information about the visitor team colors

    color

    The main color code of the visitor team

    kit_colors

    The kit color codes of the local team

    deleted

    Indicates if the team was deleted. More information: Keep in Sync

    is_placeholder

    This property indicates if the resource is used to display dummy data. The false of this property will always be a boolean value.

    leagues

    Filter on a list of league id's separated by comma. Can be used by adding &leagues= etc to your request url.

    status

    Filter fixtures based on a comma separated list of status codes as defined in the "Statuses & Definitions" documentation page. Can be used by adding &status= etc to your request url.

    The unique id of the season the fixture belongs to

    stage_id

    The unique id of the stage the fixture belongs to

    round_id

    The unique id of the round the fixture belongs to

    group_id

    The unique id of the group the fixture belongs to

    aggregate_id

    Indicates if the fixture has an aggregated score

    venue_id

    The unique id of the venue the fixture is played at

    referee_id

    The unique id of the referee that is in charge of the fixture

    localteam_id

    The unique id of the local team

    visitorteam_id

    The unique id of the visitor team

    winnerteam_id

    Contains the id of the team that won the fixture

    weather_report

    Opens an array of weather details. Possible values of the data in this array can be found in our statuses and definitions

    commentaries

    Indicates if this fixture has commentaries available

    attendance

    Give information about the visitor attendance of the fixture

    pitch

    Gives information about the pitch. Possible values can be found in our statuses and definitions

    details

    Optional additional information.

    neutral_venue

    Indicates if the fixture was played at a neutral fixture. This often happens in cup finals

    formations

    Opens an array containing the lineup formations of the teams. Possible values can be found in our statuses and definitions

    scores

    Opens an array containing the scores of the fixture

    localteam_score

    The number of goals the local team has scored in this fixture

    visitorteam_score

    The number of goals the visitor team has scored in this fixture

    localteam_pen_score

    The number of penalty goals the local team has scored in this fixture (only available when the fixture goes into penalty shootout)

    visitorteam_pen_score

    The number of penalty goals the visitor team has scored in this fixture (only available when the fixture goes into penalty shootout)

    ht_score

    The score at halftime

    ft_score

    The score at full time (90 minutes)

    et_score

    The score in extra time (only available when the fixture goes into extra time)

    ps_score

    The score of the penalty shootout (only available when the fixture goes into penalty shootout)

    time

    Opens an array containing the time details of the fixture

    status

    Indicates in which phase the fixture is in. Possible values can be found in our statuses and definitions

    starting_at

    Opens an array containing the time details of the fixture

    date_time

    Gives the date and time the fixture starts

    date

    Gives the date on which the fixture is played

    time

    Gives the starting time of the fixture

    timestamp

    The timestamp notation of the match

    timezone

    Indicates in which timezone you've requested the data

    minute

    Indicates in which minute the fixture is in

    second

    Indicates in which second the fixture is in

    added_time

    Indicates how much added time is added

    extra_minute

    Extra minute is when a fixture goes to extra time. Extra_minute will count from 0 to 15 and from 15 to 30.

    injury_time

    In case of added time, it will end up in injury_minute

    coaches

    Opens an array containing the unique id's of the coaches

    localteam_coach_id

    The unique id of the coach from the local team

    visitorteam_coach_id

    The unique id of the coach from the visitor team

    standings

    Opens an array containing the standings of the local- and visitor team

    localteam_position

    Indicates in which positions the local team is before the fixture

    visitorteam_position

    Indicates in which positions the visitor team is before the fixture

    assistants

    Opens an array containing the unique id's of the assistant referees

    first_assistant_id

    The unique id of the first assistant

    second_assistant_id

    The unique id of the second assistant

    fourth_official_id

    The unique id of the fourth official

    leg

    Indicates in how many legs this fixture is played

    colors

    Opens an array containing information about the team colors

    localteam

    Opens an array containing information about the local team colors

    color

    The main color code of the local team

    kit_colors

    The kit color codes of the local team

    visitorteam

    Opens an array containing information about the visitor team colors

    color

    The main color code of the visitor team

    kit_colors

    The kit color codes of the local team

    deleted

    Indicates if the team was deleted. More information: Keep in Sync

    is_placeholder

    This property indicates if the resource is used to display dummy data. The false of this property will always be a boolean value.

    The unique id of the season the fixture belongs to

    stage_id

    The unique id of the stage the fixture belongs to

    round_id

    The unique id of the round the fixture belongs to

    group_id

    The unique id of the group the fixture belongs to

    aggregate_id

    Indicates if the fixture has an aggregated score

    venue_id

    The unique id of the venue the fixture is played at

    referee_id

    The unique id of the referee that is in charge of the fixture

    localteam_id

    The unique id of the local team

    visitorteam_id

    The unique id of the visitor team

    winnerteam_id

    Contains the id of the team that won the fixture

    weather_report

    Opens an array of weather details. Possible values of the data in this array can be found in our statuses and definitions

    commentaries

    Indicates if this fixture has commentaries available

    attendance

    Give information about the visitor attendance of the fixture

    pitch

    Gives information about the pitch. Possible values can be found in our statuses and definitions

    details

    Optional additional information.

    neutral_venue

    Indicates if the fixture was played at a neutral fixture. This often happens in cup finals

    formations

    Opens an array containing the lineup formations of the teams. Possible values can be found in our statuses and definitions

    scores

    Opens an array containing the scores of the fixture

    localteam_score

    The number of goals the local team has scored in this fixture

    visitorteam_score

    The number of goals the visitor team has scored in this fixture

    localteam_pen_score

    The number of penalty goals the local team has scored in this fixture (only available when the fixture goes into penalty shootout)

    visitorteam_pen_score

    The number of penalty goals the visitor team has scored in this fixture (only available when the fixture goes into penalty shootout)

    ht_score

    The score at halftime

    ft_score

    The score at full time (90 minutes)

    et_score

    The score in extra time (only available when the fixture goes into extra time)

    ps_score

    The score of the penalty shootout (only available when the fixture goes into penalty shootout)

    time

    Opens an array containing the time details of the fixture

    status

    Indicates in which phase the fixture is in. Possible values can be found in our statuses and definitions

    starting_at

    Opens an array containing the time details of the fixture

    date_time

    Gives the date and time the fixture starts

    date

    Gives the date on which the fixture is played

    time

    Gives the starting time of the fixture

    timestamp

    The timestamp notation of the match

    timezone

    Indicates in which timezone you've requested the data

    minute

    Indicates in which minute the fixture is in

    second

    Indicates in which second the fixture is in

    added_time

    Indicates how much added time is added

    extra_minute

    Extra minute is when a fixture goes to extra time. Extra_minute will count from 0 to 15 and from 15 to 30.

    injury_time

    In case of added time, it will end up in injury_minute

    coaches

    Opens an array containing the unique id's of the coaches

    localteam_coach_id

    The unique id of the coach from the local team

    visitorteam_coach_id

    The unique id of the coach from the visitor team

    standings

    Opens an array containing the standings of the local- and visitor team

    localteam_position

    Indicates in which positions the local team is before the fixture

    visitorteam_position

    Indicates in which positions the visitor team is before the fixture

    assistants

    Opens an array containing the unique id's of the assistant referees

    first_assistant_id

    The unique id of the first assistant

    second_assistant_id

    The unique id of the second assistant

    fourth_official_id

    The unique id of the fourth official

    leg

    Indicates in how many legs this fixture is played

    colors

    Opens an array containing information about the team colors

    localteam

    Opens an array containing information about the local team colors

    color

    The main color code of the local team

    kit_colors

    The kit color codes of the local team

    visitorteam

    Opens an array containing information about the visitor team colors

    color

    The main color code of the visitor team

    kit_colors

    The kit color codes of the local team

    deleted

    Indicates if the team was deleted. More information: Keep in Sync

    is_placeholder

    This property indicates if the resource is used to display dummy data. The false of this property will always be a boolean value.

    Run in Postman
    Run in Postman
    Run in Postman
    Run in Postman