---
updatedAt: 2025-09-18T19:22:11.000Z
agentTools:
siteIndex: https://developer.sportradar.com/llms.txt
projectIndex: https://developer.sportradar.com/odds/v1/llms.txt
---
# Sport Tournaments
Returns a list of tournaments for a given sport ID that have schedules available.
### Update Frequency
300s Time To Live / Cache
***
## Data Points
| Attribute | Parent Element | Type | Description |
| -------------- | ------------------------- | ------ | ------------------------------------------------------------------------------ |
| `id` | `sport` | GUID | Unique ID of a sport
ex. `sr:sport:1` (Soccer) |
| `name` | `sport` | String | Name of a sport
ex. `Soccer` |
| `country_code` | `tournament` - `category` | String | Country code of a category for a tournament
ex. `USA` (USA, MLB) |
| `id` | `tournament` - `category` | GUID | Unique ID of a category for a tournament
ex. `sr:category:16` (MLB) |
| `name` | `tournament` - `category` | String | Name of a category for a tournament
ex. `USA` |
| `id` | `tournament` - `sport` | GUID | Unique ID of a tournament's sport
ex. `sr:sport:3` (Baseball) |
| `name` | `tournament` - `sport` | String | Name of a tournament's sport
ex. `Baseball` |
| Attribute | Parent Element | Type | Description |
| ------------ | ------------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `end_date` | `tournament` - `current_season` | Date | End date of a tournament's current season
ex. `2024-11-03` |
| `id` | `tournament` - `current_season` | UID | Unique SR ID of a tournament's current season
ex. `sr:season:112588`
Click [here](https://developer.sportradar.com/getting-started/docs/id-types#primary-ids) for more info on Sportradar IDs |
| `name` | `tournament` - `current_season` | String | Name of a tournament's current season
ex. `MLB 2024` |
| `start_date` | `tournament` - `current_season` | Date | Start date of a tournament's current season
ex. `2024-03-20` |
| `year` | `tournament` - `current_season` | Integer | Year of a tournament's current season
ex. `2024` |
| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id` | `tournament` | UID | Unique SR ID of a tournament
ex. `sr:tournament:109`
Click [here](https://developer.sportradar.com/getting-started/docs/id-types#primary-ids) for more info on Sportradar IDs |
| `name` | `tournament` | String | Name of a tournament
ex. `MLB` |
| `type` | `tournament` | String | Type of a tournament |
| `uuids` | `tournament` | String | Unique UUID(s) of a tournament
ex. `2ea6efe7-2e21-4f29-80a2-0a24ad1f5f85,2fa448bc-fc17-4d3d-be03-e60e080fdc26`
Click [here](https://developer.sportradar.com/getting-started/docs/id-types#primary-ids) for more info on Sportradar IDs |
# OpenAPI definition
```json
{
"openapi": "3.1.0",
"info": {
"title": "sportradar-api",
"version": "2"
},
"servers": [
{
"url": "https://api.sportradar.com/"
}
],
"components": {
"securitySchemes": {
"sec0": {
"type": "apiKey",
"in": "header",
"name": "x-api-key"
}
}
},
"security": [
{
"sec0": []
}
],
"paths": {
"/oddscomparison-{package_type}{access_level}1/{language_code}/{odds_format}/sports/{sport_id}/tournaments.{format}": {
"get": {
"summary": "Sport Tournaments",
"description": "Returns a list of tournaments for a given sport ID that have schedules available.",
"operationId": "oc-regular-sport-tournaments",
"parameters": [
{
"name": "package_type",
"in": "path",
"description": "Odds package type, with configured bookmakers prominent in either the US or global markets
`us` (United States), `row` (Rest of World)",
"schema": {
"type": "string",
"enum": [
"us",
"row"
],
"default": "us"
},
"required": true
},
{
"name": "access_level",
"in": "path",
"description": "The access level of your API key
`t` (Trial), `p` (Production)",
"schema": {
"type": "string",
"enum": [
"t",
"p"
],
"default": "t"
},
"required": true
},
{
"name": "language_code",
"in": "path",
"description": "2-letter code for supported languages
`en` (English)
English is the only fully supported language for this API. Click [here](https://api-docs.sportradar.us/misc/Sportradar_API_Languages.xlsx) for valid language codes and a tabular list of available languages per competition.",
"schema": {
"type": "string",
"default": "en"
},
"required": true
},
{
"name": "odds_format",
"in": "path",
"description": "Odds type in 2-letter format
`us` (American), `uk` (Fractional), `eu` (Decimal)",
"schema": {
"type": "string",
"enum": [
"us",
"uk",
"eu"
],
"default": "us"
},
"required": true
},
{
"name": "sport_id",
"in": "path",
"description": "Unique Id of a sport
**Examples**: `sr:sport:1` (Soccer) or `sr:sport:2` (Basketball)
Find the complete list of available sports in the [Sports](https://developer.sportradar.com/odds/reference/oc-regular-sports) endpoint",
"schema": {
"type": "string",
"default": "sr:sport:1"
},
"required": true
},
{
"name": "format",
"in": "path",
"description": "Format returned
`json`, `xml`",
"schema": {
"type": "string",
"enum": [
"json",
"xml"
],
"default": "json"
},
"required": true
}
],
"responses": {
"200": {
"description": "200",
"content": {
"application/json": {
"examples": {
"Result": {
"value": "{\n \"generated_at\": \"2023-05-11T18:55:19+00:00\",\n \"schema\": \"https://schemas.sportradar.com/sportsapi/bsa/oddscomparison/v1/schemas/sport_tournaments.json\",\n \"sport\": {\n \"id\": \"sr:sport:1\",\n \"name\": \"Soccer\"\n },\n \"tournaments\": [\n {\n \"id\": \"sr:tournament:7\",\n \"name\": \"UEFA Champions League\",\n \"sport\": {\n \"id\": \"sr:sport:1\",\n \"name\": \"Soccer\"\n },\n \"category\": {\n \"id\": \"sr:category:393\",\n \"name\": \"International Clubs\"\n },\n \"current_season\": {\n \"id\": \"sr:season:93959\",\n \"name\": \"UEFA Champions League 22/23\",\n \"start_date\": \"2022-06-21\",\n \"end_date\": \"2023-06-10\",\n \"year\": \"22/23\"\n },\n \"uuids\": \"7a480297-4942-4426-ba1d-a37284fe4dc2\"\n },\n {\n \"id\": \"sr:tournament:8\",\n \"name\": \"LaLiga\",\n \"sport\": {\n \"id\": \"sr:sport:1\",\n \"name\": \"Soccer\"\n },\n \"category\": {\n \"id\": \"sr:category:32\",\n \"name\": \"Spain\",\n \"country_code\": \"ESP\"\n },\n \"current_season\": {\n \"id\": \"sr:season:94215\",\n \"name\": \"LaLiga 22/23\",\n \"start_date\": \"2022-08-12\",\n \"end_date\": \"2023-06-04\",\n \"year\": \"22/23\"\n },\n \"uuids\": \"64e90d00-9ea0-4c91-8292-e78414439d54\"\n },\n {\n \"id\": \"sr:tournament:9\",\n \"name\": \"Challenger Pro League\",\n \"sport\": {\n \"id\": \"sr:sport:1\",\n \"name\": \"Soccer\"\n },\n \"category\": {\n \"id\": \"sr:category:33\",\n \"name\": \"Belgium\",\n \"country_code\": \"BEL\"\n },\n \"current_season\": {\n \"id\": \"sr:season:94835\",\n \"name\": \"Challenger Pro League 22/23\",\n \"start_date\": \"2022-08-12\",\n \"end_date\": \"2023-05-15\",\n \"year\": \"22/23\"\n }\n }\n {\n \"id\": \"sr:tournament:36945\",\n \"name\": \"Liga Profesional, Reserves\",\n \"sport\": {\n \"id\": \"sr:sport:1\",\n \"name\": \"Soccer\"\n },\n \"category\": {\n \"id\": \"sr:category:48\",\n \"name\": \"Argentina\",\n \"country_code\": \"ARG\"\n },\n \"current_season\": {\n \"id\": \"sr:season:100729\",\n \"name\": \"Liga Profesional, Reserves 2023\",\n \"start_date\": \"2023-01-26\",\n \"end_date\": \"2023-08-07\",\n \"year\": \"2023\"\n }\n }\n ]\n}"
}
}
}
}
}
},
"deprecated": false
}
}
},
"x-readme": {
"headers": [],
"explorer-enabled": true,
"proxy-enabled": true
},
"x-readme-fauxas": true
}
```