Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Reference Docs

Competitor Profile

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

⏱️

Update Frequency

300s Time To Live / Cache


Data Points

<Accordion title="Category & Sport" icon="fa-duotone fa-thin fa-football"> | Attribute | Parent Element | Type | Description | | --------- | -------------- | ---- | ----------- | | `country_code` | `competitor_profile` - `category` | String | Country code for a competitor's category<br />ex. `CAN` (Canada) | | `id` | `competitor_profile` - `category` | String | Unique category ID for a competitor<br />ex. `sr:category:93` | | `name` | `competitor_profile` - `category` | String | Name for a competitor's category<br />ex. `Canada` | | `id` | `competitor_profile` - `sport` | String | Unique sport ID for a competitor<br />`sr:sport:16` | | `name` | `competitor_profile` - `sport` | String | Name for a competitor's sport<br />`American Football` | </Accordion>

<Accordion title="Competitor" icon="fa-duotone fa-thin fa-football"> | Attribute | Parent Element | Type | Description | | --------- | -------------- | ---- | ----------- | | `abbreviation` | `competitor` | String | Abbreviation for a competitor name<br />ex. `DEN` (Denver Broncos) | | `age_group` | `competitor` | String | Age group of a competitor, when applicable<br />ex. `U23` | | `country` | `competitor` | String | Country of a competitor<br />ex. `USA` | | `country_code` | `competitor` | String | Country code of a competitor<br />ex. `USA` (United States)) | | `division` | `competitor` | Integer | Division number for a competitor | | `gender` | `competitor` | String | Gender for a competitor<br />`male`, `female` | | `id` | `competitor` | String | Unique ID for a competitor<br />ex. `sr:competitor:4418` (Denver Broncos) | | `name` | `competitor` | String | Name for a competitor<br />ex. `Denver Broncos` | | `state` | `competitor` | String | State of a competitor<br />ex. `CO` (Colorado) | | `virtual` | `competitor` | Boolean | Signifies a competitor is a virtual team whan `true`. Used for placeholder teams in TBD vs TBD matchups. | </Accordion>

<Accordion title="Jersey" icon="fa-duotone fa-thin fa-football"> | Attribute | Parent Element | Type | Description | | --------- | -------------- | ---- | ----------- | | `base` | `jerseys` - `jersey` | String | RGB color code of a competitor's base jersey<br />ex. `fb4f14` | | `horizontal_stripes` | `jerseys` - `jersey` | Boolean | Signifies a competitor's jersey has horizontal stripes when `true` | | `number` | `jerseys` - `jersey` | String | RGB color code of a competitor's jersey number<br />ex. `ffffff` | | `shirt_type` | `jerseys` - `jersey` | String | Shirt type of a competitor's jersey<br />ex. `short_sleeves` | | `sleeve` | `jerseys` - `jersey` | String | RGB color code of a competitor's jersey sleeves<br />ex. `fb4f14` | | `sleeve_detail` | `jerseys` - `jersey` | String | RGB color code of a competitor's jersey sleeve detail<br />ex. `081368` | | `split` | `jerseys` - `jersey` | Boolean | Signifies a competitor's jersey is split when `true` | | `squares` | `jerseys` - `jersey` | Boolean | Signifies a competitor's jersey is squares when `true` | | `stripes` | `jerseys` - `jersey` | Boolean | Signifies a competitor's jersey has stripes when `true` | | `type` | `jerseys` - `jersey` | String | Type of competitor jersey entry<br />ex. `home`, `away`, `third` | </Accordion>

<Accordion title="Player" icon="fa-duotone fa-thin fa-football">

[block:parameters] { "data": { "h-0": "Attribute", "h-1": "Parent Element", "h-2": "Type", "h-3": "Description", "0-0": "`country_code`", "0-1": "`players` - `player`", "0-2": "String", "0-3": "Country code of a player<br />ex. `USA` (United States)", "1-0": "`date_of_birth`", "1-1": "`players` - `player`", "1-2": "Date", "1-3": "Date of birth of a player<br />ex. `2000-02-25`", "2-0": "`gender`", "2-1": "`players` - `player`", "2-2": "String", "2-3": "Gender of a player<br />`male`, `female`", "3-0": "`height`", "3-1": "`players` - `player`", "3-2": "Integer", "3-3": "Height of a player in centimeters<br />ex. `188`", "4-0": "`id`", "4-1": "`players` - `player`", "4-2": "String", "4-3": "Unique ID of a player<br />ex. `sr:player:1692885`", "5-0": "`jersey_number`", "5-1": "`players` - `player`", "5-2": "Integer", "5-3": "Jersey number of a player", "6-0": "`name`", "6-1": "`players` - `player`", "6-2": "String", "6-3": "Name of a player<br />ex. `Nix, Bo`", "7-0": "`nationality`", "7-1": "`players` - `player`", "7-2": "String", "7-3": "Nationality of a player<br />ex. `United states`", "8-0": "`nickname`", "8-1": "`players` - `player`", "8-2": "String", "8-3": "Nickname of a player", "9-0": "`type`", "9-1": "`players` - `player`", "9-2": "String", "9-3": "Position of a player<br /><br />See the **enum_player_type** entry in our [Open API Spec](https://api.sportradar.com/americanfootball/trial/v2/openapi/swagger/index.html) for a complete list of player positions<br />ex. `QB`, `WR`, `TE`, `DB`", "10-0": "`weight`", "10-1": "`players` - `player`", "10-2": "Integer", "10-3": "Weight of a player in kilograms<br />ex. `97`" }, "cols": 4, "rows": 11, "align": [ null, null, null, null ] } [/block]

</Accordion>

<Accordion title="Venue" icon="fa-duotone fa-thin fa-football"> | Attribute | Parent Element | Type | Description | | --------- | -------------- | ---- | ----------- | | `capacity` | `venue` | Integer | Capacity of a competitor's home venue<br />ex. `76125` | | `city_name` | `venue` | String | City name of a competitor's home venue<br />ex. `Denver` | | `country_code` | `venue` | String | Country code of a competitor's home venue<br />ex. `USA` (United States) | | `country_name` | `venue` | String | Country name of a competitor's home venue<br />ex. `USA` | | `id` | `venue` | String | Unique ID of a competitor's home venue<br />ex. `sr:venue:8179` | | `map_coordinates` | `venue` | String | Coordinates of a competitor's home venue<br />ex. `39.743865,-105.020158` | | `name` | `venue` | String | Name of a competitor's home venue<br />ex. `Empower Field at Mile High` | | `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<br />ex. `America/Denver` | </Accordion>


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