get https://api.sportradar.com////tournaments//schedule.
Returns a list of scheduled sport events by tournament.
Update Frequency
1s Time To Live / Cache
Pagination Note
Pagination will often be required to pull all data within this feed. By default, the feed will return 100 sport events.
Data Points
Books:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
id | market - book | GUID | Unique ID of a sportsbook for a market ex. sr:book:18186 |
name | market - book | String | Name of a sportsbook for a market ex. FanDuel |
removed | market - book | String | Signifies a book market has been removed when true |
Sport & Category:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
country_code | (sport_event) - tournament - category | String | Country code of a category for a sport event ex. USA (USA, MLB) |
id | (sport_event) - tournament - category | GUID | Unique ID of a category for a sport event ex. sr:category:16 (MLB) |
name | (sport_event) - tournament - category | String | Name of a category for a sport event ex. USA |
id | (sport_event) - tournament - sport | GUID | Unique ID of a sport ex. sr:sport:3 (Baseball) |
name | (sport_event) - tournament - sport | String | Name of a sport ex. Baseball |
Competitor:
Competitors may be teams or players. Each will appear with unique competitor IDs (
sr:competitor:xxxx).
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
abbreviation | sport_event - competitors - competitor | String | Abbreviated name of a competitor ex. LOS (Los Angeles Dodgers) or HAA (Haaland, Erling Braut) |
country | sport_event - competitors - competitor | String | Country name of a competitor ex. USA |
country | sport_event - competitors - competitor | String | Country code of a competitor ex. USA |
id | sport_event - competitors - competitor | String | Unique SR ID of a competitor ex. sr:competitor:3638Click here for more info on Sportradar IDs |
name | sport_event - competitors - competitor | String | Name of a competitor ex. Los Angeles Dodgers or Haaland, Erling Braut |
qualifier | sport_event - competitors - competitor | String | Signifies a competitor as the home or away team ex. home, away |
rotation_number | sport_event - competitors - competitor | Integer | Rotation number of a competitor bet ex. 930 |
uuids | sport_event - competitors - competitor | String | Unique UUID(s) of a competitor ex. ef64da7f-cfaf-4300-87b0-9313386b977cClick here for more info on Sportradar IDs |
Season:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
end_date | sport_event - season | Date | End date of a sport event's season ex. 2024-11-03 |
id | sport_event - season | UID | Unique SR ID of a sport event's season ex. sr:season:112588Click here for more info on Sportradar IDs |
name | sport_event - season | String | Name of a sport event's season ex. MLB 2024 |
start_date | sport_event - season | Date | Start date of a sport event's season ex. 2024-03-20 |
tournament_id | sport_event - season | UID | Unique SR ID of a sport event's season tournament ex. sr:tournament:109Click here for more info on Sportradar IDs |
tournament_uuids | sport_event - season | String | Unique UUID of a sport event's season tournament(s) ex. 2ea6efe7-2e21-4f29-80a2-0a24ad1f5f85,2fa448bc-fc17-4d3d-be03-e60e080fdc26Click here for more info on Sportradar IDs |
uuids | sport_event - season | String | Unique UUID(s) of a sport event's season ex. 6a5c278f-ebce-41f9-b1ba-2160b6af04ce,f23888ed-6ca7-45bf-99e1-24b7393f540cClick here for more info on Sportradar IDs |
year | sport_event - season | Integer | Year of a sport event's season ex. 2024 |
Tournament:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
id | (sport_event) - tournament | UID | Unique SR ID of a sport event's tournament ex. sr:tournament:109Click here for more info on Sportradar IDs |
name | (sport_event) - tournament | String | Name of a sport event's tournament ex. MLB |
type | (sport_event) - tournament | String | Type of a sport event's tournament |
uuids | (sport_event) - tournament | String | Unique UUID(s) of a sport event's tournament ex. 2ea6efe7-2e21-4f29-80a2-0a24ad1f5f85,2fa448bc-fc17-4d3d-be03-e60e080fdc26Click here for more info on Sportradar IDs |
Tournament Round:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
cup_round_match_number | sport_event - tournament_round | Integer | Round match number of a sport event's tournament round |
cup_round_matches | sport_event - tournament_round | Integer | Number of matches in a sport event's tournament round |
group | sport_event - tournament_round | String | Group name of a sport event's tournament round ex. Pacific League |
name | sport_event - tournament_round | String | Name of a sport event's tournament round ex. semifinal, round_of_16 |
number | sport_event - tournament_round | Integer | Round number of a sport event's tournament round |
other_match_id | sport_event - tournament_round | UID | A linked sport event ID, typically in a two-legged tie ex. sr:sport_event:47395897 |
phase | sport_event - tournament_round | String | Phase of a sport event's tournament round ex. regular season |
tournament_match_number | sport_event - tournament_round | Integer | Tournament match number of a sport event's tournament round |
type | sport_event - tournament_round | String | Type of a sport event's tournament round ex. cup, group |
Sport Event:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
id | sport_event | String | Unique SR ID of a sport event ex. sr:sport_event:47395897 |
replaced_by | sport_event | String | An alternative sport event ID if the match is postponed and played at a later date ex. sr:sport_event:47395897 |
scheduled | sport_event | Date | Scheduled start time of a sport event ex. 2024-03-26T20:00:00+00:00 |
start_time_tbd | sport_event | Boolean | Signifies the start time of a sport event is TBD (to be determined) when true |
status | sport_event | String | Status of a sport event ex. not_started,closed, live |
uuids | sport_event | String | Unique UUID(s) of a sport event ex. f644dde6-39cc-434f-8758-18da232dc4ecClick here for more info on Sportradar IDs |
Market:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
group_name | markets - market | String | Group name of a market ex. regular |
name | markets - market | String | Name of a market. Click here for a complete list of available markets and their IDs ex. 2way, 3way, total, run_line, handicap, asian_handicap, first_team_to_score, 1x2_half_time |
odds_type_id | markets - market | Integer | ID for a type of market |
last_updated | markets | Date | Timestamp of the last update to markets ex. 2024-08-29T03:10:12+00:00 |
Market Outcome:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
handicap | market - book - outcome | String | Handicap value of a book outcome. Used for handicap and asian_handciap marketsex. -1 (home) and 1 (away) or -1.5 (home) and 1.5 (away) |
odds | market - book - outcome | String | Odds value of a book outcome ex. -105 (us), 1.952 (eu), 119/125 (uk) |
odds_field_id | market - book - outcome | Integer | Identifier for the ouctome type ex. 1 & 2 for home & away. 3, 4, & 5 for home, draw, & away |
odds_trend | market - book - outcome | String | Odds trending value of a book outcome ex. down, up |
opening_odds | market - book - outcome | String | Opening odds value of a book outcome ex. -105 (us), 1.952 (eu), 119/125 (uk) |
opening_spread | market - book - outcome | Double | Opening spread line of a book outcome ex. -1.5 (Baseball runs), -17 (Football points) |
opening_total | market - book - outcome | Double | Opening total line of a book outcome ex. 8.5 (Baseball runs), -65.5 (Football points) |
spread | market - book - outcome | Double | Spread line of a book outcome ex. -1.5 (Baseball runs), -17 (Football points) |
total | market - book - outcome | Double | Total line of a book outcome ex. 8.5 (Baseball runs), -65.5 (Football points) |
type | market - book - outcome | String | Type of bet placements on a book outcome ex. home or away |
Consensus Bet Percentage:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
name | consensus - bet_percentage_outcomes - market | String | Name of a bet percentage market. ex. moneyline, run_line, total, spread |
percentage | consensus - bet_percentage_outcomes - market - outcome | Double | Percentage of bet placements on a market outcome ex. 47 (home) & 53 (away) |
type | consensus - bet_percentage_outcomes - market - outcome | String | Type of bet placements on a market outcome ex. home or away |
Consensus Lines:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
name | consensus - lines - line | String | Name of a consensus line market. ex. moneyline_current, moneyline_open, run_line_current, run_line_open, total_current, total_open, asian_handicap_current, asian_handicap_open |
handicap | consensus - lines - line | String | Handicap value of a consensus line outcome. Used for handicap and asian_handciap marketsex. -1 or 1 |
spread | consensus - lines - line | Double | Spread line of a consensus line outcome ex. -1.5 (Baseball runs), -17 (Football points) |
total | consensus - lines - line | Double | Total line of a consensus line outcome ex. 8.5 (Baseball runs), -65.5 (Football points) |
odds | consensus - lines - line - outcome | String | Odds value of bet placements on a consensus line outcome ex. -105 (us), 1.952 (eu), 119/125 (uk) |
total | consensus - lines - line - outcome | Double | Total line of a consensus line outcome ex. 8.5 (Baseball runs), -65.5 (Football points) |
type | consensus - lines - line - outcome | String | Type of bet placements on a consensus line outcome ex. home or away |
Venue:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
capacity | venue | Integer | Capacity of a venue ex. 60000 |
city_name | venue | String | City name of a venue ex. Liverpool |
country_code | venue | String | Country code of a venue ex. ENG (England) |
country_name | venue | String | Country name of a venue ex. England |
id | venue | String | Unique ID of a venue ex. sr:venue:579 |
map_coordinates | venue | String | Coordinates of a venue ex. 53.430622,-2.960919 |
name | venue | String | Name of a venue ex. Anfield |
uuids | venue | String | Unique UUID of a venue ex. f3690068-b967-4335-9182-69c3554f8de2Click here for more info on Sportradar IDs |