Endpoint

The competitor profile endpoint returns the competitor's information who can take part in a tournament. Here, a competitor can be a player or a team. When a player ID is provided as input, this endpoint returns the player's information, including their name, nationality, gender, associated sport, and category.

Endpoint Parameters

Parameter	Description	Possible Values
language Required	Language code for translation.	See all supported languages and their codes on language support
urn_type Required	The type of event to look up.	competitor, simple_team
match_id Required	The ID of the competitor (team or player)	E.g: 92877 ; 92877 corresponds to a player ID and

Competitor information

get

Name and details about a competitor (team, tennis player, race driver etc.). xml schema

Authorizations

key

x-access-tokenstringRequired

Path parameters

languagestringRequired

Language code for translation.

urn_typestring · enumRequired

Choose if you want to look for a team or a competitor

Possible values:

idintegerRequired

The ID for the competitior.

Responses

200

successful operation

application/xml

401

Unauthorized

application/json

403

Access denied

application/json

500

Internal server error

application/json

get

/sports/{language}/competitors/sr:{urn_type}:{id}/profile.xml

HTTPcURLJavaScriptPython

GET /v1/sports/{language}/competitors/sr:{urn_type}:{id}/profile.xml HTTP/1.1
Host: global.api.betradar.com
x-access-token: YOUR_API_KEY
Accept: */*

<competitor_profile xmlns="http://schemas.sportradar.com/sportsapi/v1/unified" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" generated_at="2023-11-20T09:27:55+00:00" xsi:schemaLocation="http://schemas.sportradar.com/sportsapi/v1/unified http://schemas.sportradar.com/ufsportsapi/v1/endpoints/unified/ufsportsapi.xsd">
  <competitor id="sr:competitor:3427" name="Los Angeles Lakers" abbreviation="LAL" short_name="LA Lakers" country="USA" country_code="USA" gender="male" state="CA">
    <sport id="sr:sport:2" name="Basketball"/>
    <category id="sr:category:15" name="USA" country_code="USA"/>
  </competitor>
  <venue id="sr:venue:6008" name="Crypto.com Arena" capacity="18997" city_name="Los Angeles" country_name="USA" country_code="USA" map_coordinates="34.043059,-118.267223" state="CA"/>
  <jerseys>
    <jersey type="home" base="ffffff" sleeve="ffd500" number="6633cc" stripes="false" horizontal_stripes="false" squares="false" split="false" shirt_type="no_sleeves"/>
    <jersey type="away" base="ffdd00" sleeve="8902f7" number="8000ff" stripes="false" horizontal_stripes="false" squares="false" split="false" shirt_type="no_sleeves"/>
    <jersey type="third" base="7d009c" sleeve="ffdd00" number="ffdd00" stripes="false" horizontal_stripes="false" squares="false" split="false" shirt_type="no_sleeves"/>
  </jerseys>
  <players>
    <player type="guard" date_of_birth="2003-06-19" nationality="Usa" country_code="USA" height="198" weight="98" full_name="Jalen Hood-Schifino" gender="male" id="sr:player:2433833" name="Hood Schifino, Jalen"/>
    <player type="guard" date_of_birth="1996-02-23" nationality="Usa" country_code="USA" height="193" weight="88" jersey_number="1" full_name="D'Angelo Russell" gender="male" id="sr:player:852034" name="Russell, D'Angelo"/>
    <!-- additional players omitted for brevity -->
  </players>
</competitor_profile>