---
updatedAt: 2025-09-18T19:16:37.000Z
agentTools:
siteIndex: https://developer.sportradar.com/llms.txt
projectIndex: https://developer.sportradar.com/odds/v1/llms.txt
---
# Daily Sport Schedule
Returns a list of sport events for a given sport ID and date that have odds available.
### Update Frequency
60s 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
| 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` |
| 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` |
> 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:3638`
Click [here](https://developer.sportradar.com/getting-started/docs/id-types#primary-ids) 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-9313386b977c`
Click [here](https://developer.sportradar.com/getting-started/docs/id-types#primary-ids) for more info on Sportradar IDs |
| 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:112588`
Click [here](https://developer.sportradar.com/getting-started/docs/id-types#primary-ids) 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:109`
Click [here](https://developer.sportradar.com/getting-started/docs/id-types#primary-ids) 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-e60e080fdc26`
Click [here](https://developer.sportradar.com/getting-started/docs/id-types#primary-ids) 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-24b7393f540c`
Click [here](https://developer.sportradar.com/getting-started/docs/id-types#primary-ids) for more info on Sportradar IDs |
| `year` | `sport_event` - `season` | Integer | Year of a sport event's season
ex. `2024` |
| Attribute | Parent Element | Type | Description |
| --------- | ---------------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id` | `sport_event` - `tournament` | UID | Unique SR ID of a sport event's 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` | `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-e60e080fdc26`
Click [here](https://developer.sportradar.com/getting-started/docs/id-types#primary-ids) for more info on Sportradar IDs |
| 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` |
| 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-18da232dc4ec`
Click [here](https://developer.sportradar.com/getting-started/docs/id-types#primary-ids) for more info on Sportradar IDs |
| 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](https://developer.sportradar.com/odds/reference/oc-regular-overview#available-markets) 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` |
| Attribute | Parent Element | Type | Description |
| ---------------- | ----------------------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `handicap` | `market` - `book` - `outcome` | String | Handicap value of a book outcome. Used for `handicap` and `asian_handciap` markets
ex. `-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` | Number | Opening spread line of a book outcome
ex. `-1.5` (Baseball runs), `-17` (Football points) |
| `opening_total` | `market` - `book` - `outcome` | Number | Opening total line of a book outcome
ex. `8.5` (Baseball runs), `-65.5` (Football points) |
| `spread` | `market` - `book` - `outcome` | String | Spread line of a book outcome
ex. `-1.5` (Baseball runs), `-17` (Football points) |
| `total` | `market` - `book` - `outcome` | String | 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` |
| 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` | Number | 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` |
| 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` markets
ex. `-1` or `1` |
| `spread` | `consensus` - `lines` - `line` | String | Spread line of a consensus line outcome
ex. `-1.5` (Baseball runs), `-17` (Football points) |
| `total` | `consensus` - `lines` - `line` | Number | 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` | Number | 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` |
| 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-69c3554f8de2`
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}/{date}/schedule.{format}": {
"get": {
"summary": "Daily Sport Schedule",
"description": "Returns a list of sport events for a given sport ID and date that have odds available.",
"operationId": "oc-regular-daily-sport-schedule",
"parameters": [
{
"name": "start",
"in": "query",
"description": "Number to start the list of results from.
Example: start=0",
"schema": {
"type": "string"
}
},
{
"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": "limit",
"in": "query",
"description": "Number to limit the number of results. Minimum value is 0; maximum value is 100.
Example: limit=100",
"schema": {
"type": "string"
}
},
{
"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": "date",
"in": "path",
"description": "Date in `YYYY-MM-DD` format",
"schema": {
"type": "string",
"format": "date"
},
"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:41:33+00:00\",\n \"schema\": \"https://schemas.sportradar.com/sportsapi/bsa/oddscomparison/v1/schemas/sport_schedule.json\",\n \"sport\": {\n \"id\": \"sr:sport:1\",\n \"name\": \"Soccer\"\n },\n \"sport_events\": [\n {\n \"id\": \"sr:match:38185813\",\n \"scheduled\": \"2023-05-18T00:30:00+00:00\",\n \"start_time_tbd\": false,\n \"status\": \"not_started\",\n \"tournament_round\": {\n \"type\": \"group\",\n \"number\": 1,\n \"group\": \"Western Conference\"\n },\n \"season\": {\n \"id\": \"sr:season:101055\",\n \"name\": \"Major League Soccer 2023\",\n \"start_date\": \"2023-02-25\",\n \"end_date\": \"2023-12-10\",\n \"year\": \"2023\",\n \"tournament_id\": \"sr:tournament:242\"\n },\n \"tournament\": {\n \"id\": \"sr:tournament:242\",\n \"name\": \"Major League Soccer\",\n \"sport\": {\n \"id\": \"sr:sport:1\",\n \"name\": \"Soccer\"\n },\n \"category\": {\n \"id\": \"sr:category:26\",\n \"name\": \"USA\",\n \"country_code\": \"USA\"\n },\n \"uuids\": \"b4360831-aaa9-46a4-8319-62006d308eb6\"\n },\n \"competitors\": [\n {\n \"id\": \"sr:competitor:22010\",\n \"name\": \"Vancouver Whitecaps FC\",\n \"country\": \"Canada\",\n \"country_code\": \"CAN\",\n \"abbreviation\": \"VAN\",\n \"qualifier\": \"away\",\n \"uuids\": \"b9df6f63-ba46-4df9-afbd-f925bce7b012\"\n }\n ],\n \"venue\": {\n \"id\": \"sr:venue:2298\",\n \"name\": \"Toyota Stadium\",\n \"capacity\": 20500,\n \"city_name\": \"Frisco\",\n \"country_name\": \"USA\",\n \"map_coordinates\": \"33.154327,-96.835213\",\n \"country_code\": \"USA\",\n \"uuids\": \"b6d40461-52a0-4994-b182-8b567a90eb0b,be2c2421-9b4d-487d-af6b-069d631d021f\"\n },\n \"markets\": [\n {\n \"odds_type_id\": 2,\n \"name\": \"3way\",\n \"group_name\": \"regular\",\n \"books\": [\n {\n \"id\": \"sr:book:18186\",\n \"name\": \"FanDuel\",\n \"outcomes\": [\n {\n \"odds_field_id\": 3,\n \"type\": \"home\",\n \"odds\": \"-155\",\n \"opening_odds\": \"-160\",\n \"odds_trend\": \"down\"\n },\n {\n \"odds_field_id\": 5,\n \"type\": \"away\",\n \"odds\": \"+380\",\n \"opening_odds\": \"+390\",\n \"odds_trend\": \"up\"\n },\n {\n \"odds_field_id\": 4,\n \"type\": \"draw\",\n \"odds\": \"+270\",\n \"opening_odds\": \"+270\",\n \"odds_trend\": \"neutral\"\n }\n ]\n },\n {\n \"id\": \"sr:book:32219\",\n \"name\": \"WilliamHillNewJersey\",\n \"outcomes\": [\n {\n \"odds_field_id\": 3,\n \"type\": \"home\",\n \"odds\": \"-140\",\n \"opening_odds\": \"-140\",\n \"odds_trend\": \"neutral\"\n },\n {\n \"odds_field_id\": 5,\n \"type\": \"away\",\n \"odds\": \"+410\",\n \"opening_odds\": \"+410\",\n \"odds_trend\": \"neutral\"\n },\n {\n \"odds_field_id\": 4,\n \"type\": \"draw\",\n \"odds\": \"+255\",\n \"opening_odds\": \"+255\",\n \"odds_trend\": \"neutral\"\n }\n ]\n }\n ]\n }\n ],\n \"markets_last_updated\": \"2023-05-11T01:25:04+00:00\",\n \"consensus\": {\n \"lines\": [\n {\n \"name\": \"total_open\",\n \"total\": \"2.5\",\n \"outcomes\": [\n {\n \"type\": \"over\",\n \"odds\": \"+100\",\n \"total\": \"2.5\"\n },\n {\n \"type\": \"under\",\n \"odds\": \"-130\",\n \"total\": \"2.5\"\n }\n ]\n }\n ]\n }\n },\n ]\n}"
}
}
}
}
}
},
"deprecated": false
}
}
},
"x-readme": {
"headers": [],
"explorer-enabled": true,
"proxy-enabled": true
},
"x-readme-fauxas": true
}
```