Competitor Profile

get https://api.sportradar.com/soccer/{access_level}/v4/{language_code}/competitors/{competitor_id}/profile.{format}

Provides top-level information for a given team, including the full team roster, manager, home venue, and team colors.

⏱️
Update Frequency
TTL / Cache: 300 seconds
Data Updates: Player/roster data checks occur two weeks before the competition start

Data Points

Category & Sport

Attribute	Parent Element	Type	Description
`country_code`	`competitor_profile` - `category`	String	Country code for a competitor's category ex. `ENG` (England)
`id`	`competitor_profile` - `category`	String	Unique category ID for a competitor ex. `sr:category:1`
`name`	`competitor_profile` - `category`	String	Name for a competitor's category ex. `England` (Premier League)
`id`	`competitor_profile` - `sport`	String	Unique sport ID for a competitor ex. `sr:sport:1`
`name`	`competitor_profile` - `sport`	String	Name for a competitor's sport ex. `Soccer`

Competitor

Attribute	Parent Element	Type	Description
`abbreviation`	`competitor`	String	Abbreviation for a competitor name ex. `LIV` (Liverpool FC)
`age_group`	`competitor`	String	Age group of a competitor, when applicable ex. `U23`
`country`	`competitor`	String	Country of a competitor ex. `England`
`country_code`	`competitor`	String	Country code of a competitor ex. `ENG` (England)
`gender`	`competitor`	String	Gender for a competitor `male`, `female`
`id`	`competitor`	String	Unique ID for a competitor ex. `sr:competitor:44` (Liverpool FC)
`name`	`competitor`	String	Name for a competitor ex. `Liverpool FC`
`short_name`	`competitor`	String	Name for a competitor ex. `Liverpool`
`virtual`	`competitor`	Boolean	Signifies a competitor is a virtual team when `true`. Used for placeholder teams in TBD vs TBD matchups.

Jersey

Attribute	Parent Element	Type	Description
`base`	`jerseys` - `jersey`	String	RGB color code of a competitor's base jersey ex. `e41e2c`
`horizontal_stripes`	`jerseys` - `jersey`	Boolean	Signifies a competitor's jersey has horizontal stripes when `true`
`horizontal_stripes_color`	`jerseys` - `jersey`	String	RGB color code of a competitor's horizontal jersey stripes ex. `e41e2c`
`number`	`jerseys` - `jersey`	String	RGB color code of a competitor's jersey number ex. `ffffff`
`shirt_type`	`jerseys` - `jersey`	String	Shirt type of a competitor's jersey ex. `short_sleeves`
`sleeve`	`jerseys` - `jersey`	String	RGB color code of a competitor's jersey sleeves ex. `e41e2c`
`sleeve_detail`	`jerseys` - `jersey`	String	RGB color code of a competitor's jersey sleeves detail ex. `ffffff`
`split`	`jerseys` - `jersey`	Boolean	Signifies a competitor's jersey is split when `true`
`split_color`	`jerseys` - `jersey`	String	RGB color code of a competitor's jersey split ex. `ffffff`
`squares`	`jerseys` - `jersey`	Boolean	Signifies a competitor's jersey is squares when `true`
`squares_color`	`jerseys` - `jersey`	String	RGB color code of a competitor's jersey squares ex. `ffffff`
`stripes`	`jerseys` - `jersey`	Boolean	Signifies a competitor's jersey has stripes when `true`
`stripes_color`	`jerseys` - `jersey`	String	RGB color code of a competitor's jersey stripes ex. `ffffff`
`type`	`jerseys` - `jersey`	String	Type of competitor jersey entry ex. `home`, `away`, `goalkeeper`, `third`

Manager

Attribute	Parent Element	Type	Description
`country_code`	`manager`	String	Country code of a manager ex. `ENG` (England)
`date_of_birth`	`manager`	Date	Date of birth of a manager ex. `1967-06-16`
`gender`	`manager`	String	Gender of a manager `male`, `female`
`id`	`manager`	String	Unique ID of a manager ex. `sr:player:52829`
`name`	`manager`	String	Name of a manager ex. `Klopp, Jurgen`
`nationality`	`manager`	String	Nationality of a manager ex. `Germany`
`nickname`	`manager`	String	Nickname of a manager
`preferred_foot`	`manager`	String	Preferred foot of a manager `left`, `right`

Player

Attribute	Parent Element	Type	Description
`country_code`	`players` - `player`	String	Country code of a player ex. `EGY` (Egypt)
`country_of_birth`	`players` - `player`	String	Birth country of a player ex. `Egypt`
`date_of_birth`	`players` - `player`	Date	Date of birth of a player ex. `1992-06-15`
`gender`	`players` - `player`	String	Gender of a player `male`, `female`
`height`	`players` - `player`	Integer	Height of a player in centimeters ex. `175`
`id`	`players` - `player`	String	Unique ID of a player ex. `sr:player:159665`
`jersey_number`	`players` - `player`	Integer	Jersey number of a player
`loaned_to_competitor_id`	`players` - `player`	String	Unique ID of the competitor a player is currently on loan to ex. `sr:competitor:9`
`name`	`players` - `player`	String	Name of a player ex. `Salah, Mohamed`
`nationality`	`players` - `player`	String	Nationality of a player ex. `Egypt`
`nickname`	`players` - `player`	String	Nickname of a player
`on_loan`	`players` - `player`	Boolean	Signifies a player is on loan to this team when `true`
`place_of_birth`	`players` - `player`	String	Place of birth of a player ex. `Basyoun, El Gharbia`
`preferred_foot`	`players` - `player`	String	Preferred foot of a player `left`, `right`
`type`	`players` - `player`	String	Position of a player `goalkeeper`, `defender`, `midfielder`, `forward`
`weight`	`players` - `player`	Integer	Weight of a player in kilograms ex. `71`

Venue

Attribute	Parent Element	Type	Description
`capacity`	`venue`	Integer	Capacity of a competitor's home venue ex. `60000`
`changed`	`venue`	Boolean	Signifies a venue has been changed when `true`
`city_name`	`venue`	String	City name of a competitor's home venue ex. `Liverpool`
`country_code`	`venue`	String	Country code of a competitor's home venue ex. `ENG` (England)
`country_name`	`venue`	String	Country name of a competitor's home venue ex. `England`
`id`	`venue`	String	Unique ID of a competitor's home venue ex. `sr:venue:579`
`map_coordinates`	`venue`	String	Coordinates of a competitor's home venue ex. `53.430622,-2.960919`
`name`	`venue`	String	Name of a competitor's home venue ex. `Anfield`
`reduced_capacity`	`venue`	Boolean	Optional attribute signifying a venue has a restricted capacity when `true`
`reduced_capacity_max`	`venue`	Integer	Value of a venue's restrictued capacity
`timezone`	`venue`	String	Timezone of a competitor's home venue ex. `Europe/London`

Language

Credentials

Header

Click Try It! to start a request and see the response here!