Competitor Profile

get

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

Soccer Extended Competitor Profile provides top-level information for a given team, including the full team roster, manager, home venue, and team colors.

Recent Requests

Log in to see full request history

Time	Status	User Agent
Retrieving recent requests…

Loading…

⏱️
Update Frequency
300s Time To Live / Cache

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`

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
`captain`	`players` - `player`	Boolean	Indicates the player is the team captain for the associated team when `true`
`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_id`	`venue`	String	Unique ID of a city ex. `sr:city:59`
`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 restricted capacity
`timezone`	`venue`	String	Timezone of a competitor's home venue ex. `Europe/London`

Path Params

access_level

string

enum

required

Defaults to trial

The access level of your API key

trial, production

Allowed:

language_code

string

enum

required

Defaults to en

2-letter code for supported languages

da (Danish), de (German), el (Greek), en (English), es (Spanish), fi (Finnish), fr (French), id (Indonesian), it (Italian), ja (Japanese), nl (Dutch), pt (Portuguese), ru (Russian), sr (Serbian), srl (Serbian Latin), th (Thai), tr (Turkish), zh (Chinese - simplified), zht (Chinese - traditional)

The above codes are the fully supported languages for this API. Click here for valid language codes and a tabular list of available languages per competition.

competitor_id

string

required

Defaults to sr:competitor:44

Unique Id of a competitor

Example: sr:competitor:44

format

string

enum

required

Defaults to json

Format returned

json, xml

Allowed:

Response

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json