1 of 7

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.

Check this endpoint in Postman.

GET Team by ID

`GET` Team by ID

https://soccer.sportmonks.com/api/v2.0/teams/{ID}

Parameters

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

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

GET Teams by Country ID

`GET` Teams by Country ID

https://soccer.sportmonks.com/api/v2.0/countries/{ID}/teams

Parameters

Include options

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

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

GET Teams by Season ID

`GET` Team by Season ID

https://soccer.sportmonks.com/api/v2.0/teams/season/{season_ID}

Parameters

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

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

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/teams/search/{team_name}

Parameters

Include options

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

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

GET Current Leagues by Team ID

`GET` Current Leagues by Team ID

https://soccer.sportmonks.com/api/v2.0/teams/{ID}/current

Parameters

Include options

No includes available for this endpoint.

Example response

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
                    }
                }
            }
        }
    ],

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.

`GET` All Leagues by Team ID

https://soccer.sportmonks.com/api/v2.0/teams/{ID}/history

Parameters

No parameters available for this endpoint.

Include options

No includes available for this endpoint.

Example response

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

Check this endpoint in Postman.

GET Teams by Season ID

`GET` Team by Season ID

https://soccer.sportmonks.com/api/v2.0/teams/season/{season_ID}

Parameters

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

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

Check this endpoint in Postman.

Teams

GET Team by ID

GET Team by ID

Parameters

Include options

Example response

GET Teams by Country ID

GET Teams by Country ID

Parameters

Include options

Example response

GET Teams by Season ID

GET Team by Season ID

Parameters

Include options

Example response

Search Team by Name

GET Search Team by Name

Parameters

Include options

Example response

GET Current Leagues by Team ID

GET Current Leagues by Team ID

Parameters

Include options

Example response

Get All Leagues by Team ID

GET All Leagues by Team ID

Parameters

Include options

Example response

GET Team by ID

GET Team by ID

Parameters

Include options

Example response

Get All Leagues by Team ID

GET All Leagues by Team ID

Parameters

Include options

Example response

Teams

GET Current Leagues by Team ID

GET Current Leagues by Team ID

Parameters

Include options

Example response

GET Teams by Season ID

GET Team by Season ID

Parameters

Include options

Example response

Search Team by Name

GET Search Team by Name

Parameters

Include options

Example response

GET Teams by Country ID

GET Teams by Country ID

Parameters

Include options

Example response

`GET` Team by ID

`GET` Teams by Country ID

`GET` Team by Season ID

`GET` Search Team by Name

`GET` Current Leagues by Team ID

`GET` All Leagues by Team ID

`GET` Team by ID

`GET` All Leagues by Team ID

`GET` Current Leagues by Team ID

`GET` Team by Season ID

`GET` Search Team by Name

`GET` Teams by Country ID