All pages
Powered by GitBook
1 of 1

Loading...

GET Team by ID

GET Team by ID

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

Endpoint details

Authorization

API Key

Pagination

NO

Allowed nested includes

3

Parameters

Available parameters

include

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

seasons

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

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:

Includes

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

Field

Description

id

The unique id of the team

legacy_id

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

name

The name of the team

short_code

The short code of the team

twitter

The official twitter page of the team

country_id

The unique country id the team is from

national_team

Indicates if the team is a national team

founded

The year when the team was founded

logo_path

The logo URL path of the team logo

venue_id

The official venue of the team

current_season_id

The unique id of the season the team is active in

is_placeholder

Added a property on both fixture and team responses called is_placeholder. This property indicates if the resource is used to display dummy data. The false of this property will always be a boolean value.

Check this endpoint in Postman.

Run in Postman