All pages
Powered by GitBook
1 of 7

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

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 IDGET Teams by Season IDSearch Team by NameGET Current Leagues by Team IDGet All Leagues by Team ID

Check this endpoint in Postman.

Run in Postman

GET Team by ID

GET Team by ID

Endpoint details

Authorization

API Key

Parameters

Include options

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

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:

Example response

Check this endpoint in Postman.

https://soccer.sportmonks.com/api/v2.0/teams/{ID}
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.

Pagination

NO

Allowed nested includes

3

Available parameters

include

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

seasons

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

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

Includes

The short code of the team

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
    },
Run in Postman

GET Teams by Country ID

GET Teams by Country ID

Endpoint details

Authorization

API Key

Parameters

Include options

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

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:

Example response

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.

GET Search Team by Name

https://soccer.sportmonks.com/api/v2.0/countries/{ID}/teams
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.

Pagination

NO

Allowed nested includes

3

Available parameters

include

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

seasons

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

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

Includes

The short code of the team

Pagination

NO

Allowed nested includes

2

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.

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

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:

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

Check this endpoint in Postman.

Endpoint details

Authorization

API Key

Includes

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.

GET All Leagues by Team ID

Endpoint details

Authorization

API Key

Parameters

No parameters available for this endpoint.

Include options

No includes available for this endpoint.

Example response

Check this endpoint in Postman.

GET Current Leagues by Team ID

GET Current Leagues by Team ID

Endpoint details

Authorization

API Key

Parameters

Include options

No includes available for this endpoint.

Example response

Check this endpoint in Postman.

GET Teams by Season ID

GET Team by Season ID

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/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/teams/search/{team_name}
https://soccer.sportmonks.com/api/v2.0/teams/{ID}/history
https://soccer.sportmonks.com/api/v2.0/teams/{ID}/current
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

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

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

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

https://soccer.sportmonks.com/api/v2.0/teams/939/current?api_token={API_TOKEN}
"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
                    }
                }
            }
        }
    ],

YES

Allowed nested includes

3

Parameters

Available parameters

include

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

seasons

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

Include options

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

Please note that the squad include only returns the squad of the current domestic season.

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

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

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

Check this endpoint in Postman.

Endpoint details

Authorization

API Key

Pagination

Includes

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.

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/teams/season/{season_ID}
Run in Postman
here
Run in Postman
here
Run in Postman

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.

Run in Postman