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
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
get
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>

Last updated

Was this helpful?