---
updatedAt: 2026-08-04T20:01:18.000Z
agentTools:
siteIndex: https://developer.sportradar.com/llms.txt
projectIndex: https://developer.sportradar.com/cricket/llms.txt
---
# Tournament Schedule
Provides scheduling information for all matches within a given tournament or season.
### Update Frequency
300s Time To Live / Cache
***
## Data Points
> Tournament info appears at the top of the file and within each `sport_event` entry
| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `gender` | `sport_event` - `tournament` | String | Gender of a sport event's tournament
`men`, `women`, `mixed` |
| `id` | `sport_event` - `tournament` | String | Unique ID for a sport event's tournament
ex. `sr:tournament:21568` (Sheffield Shield) |
| `name` | `sport_event` - `tournament` | String | Name of a sport event's tournament
ex. `Sheffield Shield` |
| `type` | `sport_event` - `tournament` | String | Type of a sport event's tournament
`test`, `odi`, `t10`, `t20i`, `first_class`, `list_a`, `t20`, `the_hundred` |
| `competition_sport_event_number` | `sport_event` - `tournament_round` | Integer | Sport event number within a competition. Used for competitions that assign fixed match numbers (ex. IPL, World Cup) |
| `name` | `sport_event` - `tournament_round` | String | Name of a sport event's tournament round |
| `number` | `sport_event` - `tournament_round` | Integer | Number of a sport event's tournament round |
| `type` | `sport_event` - `tournament_round` | String | Type of a sport event's tournament round
ex. `group` |
> Category and sport info appears at the top of the file and within each `sport_event` entry
| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `country_code` | `sport_event` - `tournament` - `category` | String | Country code for a tournament's category |
| `id` | `sport_event` - `tournament` - `category` | String | Unique category ID for a tournament
ex. `sr:category:105` |
| `name` | `sport_event` - `tournament` - `category` | String | Name for a tournament's category
ex. `International` |
| `id` | `sport_event` - `tournament` - `sport` | String | Unique sport ID for a tournament
ex. `sr:sport:21` |
| `name` | `sport_event` - `tournament` - `sport` | String | Name for a tournament's sport
ex. `Cricket` |
| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `end_date` | `sport_event` - `season` | Date | End date of a sport event's season
ex. `2024-06-17` |
| `id` | `sport_event` - `season` | String | Unique ID for a sport event's season
ex. `sr:season:122977` (Sheffield Shield 24/25) |
| `name` | `sport_event` - `season` | String | Name of a sport event's season
ex. `Sheffield Shield 24/25` |
| `start_date` | `sport_event` - `season` | Date | Start date of a sport event's season
ex. `2023-09-23` |
| `tournament_id` | `sport_event` - `season` | String | Unique tournament ID for a sport event's season
ex. `sr:tournament:21568` (Sheffield Shield) |
| `year` | `sport_event` - `season` | String | Year of a sport event's season
ex. `23/24` or `2024` |
| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `abbreviation` | `competitors` - `team` | String | Abbreviation for a competitor name
ex. `BUL` (Queensland Bulls) |
| `country` | `competitors` - `team` | String | Country of a competitor
ex. `Australia` |
| `country_code` | `competitors` - `team` | String | Country code of a competitor
ex. `AUS` (Australia) |
| `gender` | `competitors` - `team` | String | Gender for a competitor
`male`, `female` |
| `id` | `competitors` - `team` | String | Unique ID for a competitor
ex. `sr:competitor:142678` (Queensland Bulls) |
| `name` | `competitors` - `team` | String | Name for a competitor
ex. `Queensland Bulls` |
| `qualifier` | `competitors` - `team` | String | Designation of a competitor for a sport event
`home`, `away` |
| `virtual` | `competitors` - `team` | Boolean | Signifies a competitor is a virtual team when `true`. Used for placeholder teams in TBD vs TBD matchups. |
| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `id` | `sport_event` | String | Unique ID of a sport event
ex. `sr:sport_event:52962997` |
| `scheduled` | `sport_event` | Date-time | Scheduled start time of a match
ex. `2025-02-08T00:00:00+00:00` |
| `start_time_tbd` | `sport_event` | Boolean | Signifies the start time of a match is TBD when `true` |
| `status` | `sport_event` | String | Status of a match.
See our [FAQ](https://developer.sportradar.com/cricket/reference/cricket-faq#sport-event-statuses) for a complete list of statuses and their definitions |
| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `capacity` | `venue` | Integer | Capacity of a venue
ex. `22500` |
| `city_id` | `venue` | String | Unique ID of a city
ex. `sr:city:59` |
| `city_name` | `venue` | String | City name of a venue
ex. `Sylhet` |
| `country_code` | `venue` | String | Country code of a venue
ex. `BGD` (Bangladesh) |
| `country_name` | `venue` | String | Country name of a venue
ex. `Bangladesh` |
| `id` | `venue` | String | Unique ID of a venue
ex. `sr:venue:24744` |
| `map_coordinates` | `venue` | String | Coordinates of a venue
ex. `24.920781,91.868653` |
| `name` | `venue` | String | Name of a venue
ex. `Sylhet International Cricket Stadium` |
| `timezone` | `venue` | String | Timezone of a venue
ex. `Asia/Kolkata` |
| `state` | `venue` | String | State of a venue
ex. `Sylhet International Cricket Stadium` |
| `name` | `venue` - `bowling_end` | String | Name of a venue bowling end
ex. `Anna Pavilion End`, `V Pattabhiraman Gate End` |
# 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": "query",
"name": "api_key"
}
}
},
"security": [
{
"sec0": []
}
],
"paths": {
"/cricket-{access_level}2/{language_code}/tournaments/{tournament_or_season_id}/schedule.{format}": {
"get": {
"summary": "Tournament Schedule",
"description": "Provides scheduling information for all matches within a given tournament or season.",
"operationId": "cricket-tournament-schedule",
"parameters": [
{
"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": "tournament_or_season_id",
"in": "path",
"description": "Unique Id of a tournament or season, found in the [Tournament List](https://developer.sportradar.com/cricket/reference/cricket-tournament-list) endpoint
**Example:** `sr:tournament:2472` or `sr:season:119197`",
"schema": {
"type": "string",
"default": "sr:tournament:2472"
},
"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": {
"generated_at": "2026-08-04T19:36:59.444Z",
"sport_events": [
{
"competitors": [
{
"abbreviation": "string",
"age_group": "U23",
"category": {
"country_code": "string",
"id": "string",
"name": "string"
},
"country": "string",
"country_code": "string",
"gender": "string",
"id": "string",
"ioc_code": "string",
"name": "string",
"qualifier": "home",
"sport": {
"id": "string",
"name": "string"
},
"virtual": true
}
],
"id": "string",
"replaced_by": "string",
"scheduled": "2026-08-04T19:36:59.444Z",
"season": {
"end_date": "2026-08-04",
"id": "string",
"name": "string",
"start_date": "2026-08-04",
"tournament_id": "string",
"year": "string"
},
"sport_event_conditions": {
"comment": {
"text": "string"
},
"day_night": "day",
"neutral_venue": true,
"outfield_info": {
"outfield_conditions": "slow"
},
"pitch_info": {
"boundary_position": "in",
"grass_cover": "barren",
"pitch_moisture": "very_dry",
"pitch_quality": "normal"
},
"referees": {
"referee": {
"country_code": "string",
"id": "string",
"name": "string",
"nationality": "string",
"type": "main_referee"
},
"umpires": [
{
"id": "string",
"name": "string",
"number": 0,
"type": "3rd"
}
]
},
"type": "test",
"weather_info": {
"rain_conditions": "no_rain",
"sky_conditions": "clear",
"temperature_range": "very_hot",
"wind_conditions": "no_wind"
}
},
"start_time_tbd": true,
"status": "string",
"tour": {
"category": {
"country_code": "string",
"id": "string",
"name": "string"
},
"id": "string",
"name": "string",
"sport": {
"id": "string",
"name": "string"
}
},
"tournament": {
"category": {
"country_code": "string",
"id": "string",
"name": "string"
},
"current_season": {
"end_date": "2026-08-04",
"id": "string",
"name": "string",
"start_date": "2026-08-04",
"year": "string"
},
"gender": "men",
"id": "string",
"name": "string",
"parent_id": "string",
"season_coverage_info": {
"max_coverage_level": "string",
"max_covered": "string",
"min_coverage_level": "string",
"played": 0,
"scheduled": 0,
"season_id": "string"
},
"sport": {
"id": "string",
"name": "string"
},
"tour_id": "string",
"type": "test"
},
"tournament_round": {
"competition_sport_event_number": 0,
"cup_round_match_number": 0,
"cup_round_matches": 0,
"name": "string",
"number": 0,
"other_match_id": "string",
"phase": "string",
"type": "string"
},
"venue": {
"bowling_ends": [
{
"name": "string"
}
],
"capacity": 0,
"city_id": "string",
"city_name": "string",
"country_code": "string",
"country_name": "string",
"id": "string",
"map_coordinates": "string",
"name": "string",
"state": "string",
"timezone": "string"
}
}
],
"tournament": {
"category": {
"country_code": "string",
"id": "string",
"name": "string"
},
"current_season": {
"end_date": "2026-08-04",
"id": "string",
"name": "string",
"start_date": "2026-08-04",
"year": "string"
},
"gender": "men",
"id": "string",
"name": "string",
"parent_id": "string",
"season_coverage_info": {
"max_coverage_level": "string",
"max_covered": "string",
"min_coverage_level": "string",
"played": 0,
"scheduled": 0,
"season_id": "string"
},
"sport": {
"id": "string",
"name": "string"
},
"tour_id": "string",
"type": "test"
}
}
}
},
"schema": {
"type": "object",
"properties": {
"generated_at": {
"type": "string",
"example": "2026-08-04T19:36:59.444Z"
},
"sport_events": {
"type": "array",
"items": {
"type": "object",
"properties": {
"competitors": {
"type": "array",
"items": {
"type": "object",
"properties": {
"abbreviation": {
"type": "string",
"example": "string"
},
"age_group": {
"type": "string",
"example": "U23"
},
"category": {
"type": "object",
"properties": {
"country_code": {
"type": "string",
"example": "string"
},
"id": {
"type": "string",
"example": "string"
},
"name": {
"type": "string",
"example": "string"
}
}
},
"country": {
"type": "string",
"example": "string"
},
"country_code": {
"type": "string",
"example": "string"
},
"gender": {
"type": "string",
"example": "string"
},
"id": {
"type": "string",
"example": "string"
},
"ioc_code": {
"type": "string",
"example": "string"
},
"name": {
"type": "string",
"example": "string"
},
"qualifier": {
"type": "string",
"example": "home"
},
"sport": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "string"
},
"name": {
"type": "string",
"example": "string"
}
}
},
"virtual": {
"type": "boolean",
"example": true,
"default": true
}
}
}
},
"id": {
"type": "string",
"example": "string"
},
"replaced_by": {
"type": "string",
"example": "string"
},
"scheduled": {
"type": "string",
"example": "2026-08-04T19:36:59.444Z"
},
"season": {
"type": "object",
"properties": {
"end_date": {
"type": "string",
"example": "2026-08-04"
},
"id": {
"type": "string",
"example": "string"
},
"name": {
"type": "string",
"example": "string"
},
"start_date": {
"type": "string",
"example": "2026-08-04"
},
"tournament_id": {
"type": "string",
"example": "string"
},
"year": {
"type": "string",
"example": "string"
}
}
},
"sport_event_conditions": {
"type": "object",
"properties": {
"comment": {
"type": "object",
"properties": {
"text": {
"type": "string",
"example": "string"
}
}
},
"day_night": {
"type": "string",
"example": "day"
},
"neutral_venue": {
"type": "boolean",
"example": true,
"default": true
},
"outfield_info": {
"type": "object",
"properties": {
"outfield_conditions": {
"type": "string",
"example": "slow"
}
}
},
"pitch_info": {
"type": "object",
"properties": {
"boundary_position": {
"type": "string",
"example": "in"
},
"grass_cover": {
"type": "string",
"example": "barren"
},
"pitch_moisture": {
"type": "string",
"example": "very_dry"
},
"pitch_quality": {
"type": "string",
"example": "normal"
}
}
},
"referees": {
"type": "object",
"properties": {
"referee": {
"type": "object",
"properties": {
"country_code": {
"type": "string",
"example": "string"
},
"id": {
"type": "string",
"example": "string"
},
"name": {
"type": "string",
"example": "string"
},
"nationality": {
"type": "string",
"example": "string"
},
"type": {
"type": "string",
"example": "main_referee"
}
}
},
"umpires": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "string"
},
"name": {
"type": "string",
"example": "string"
},
"number": {
"type": "integer",
"example": 0,
"default": 0
},
"type": {
"type": "string",
"example": "3rd"
}
}
}
}
}
},
"type": {
"type": "string",
"example": "test"
},
"weather_info": {
"type": "object",
"properties": {
"rain_conditions": {
"type": "string",
"example": "no_rain"
},
"sky_conditions": {
"type": "string",
"example": "clear"
},
"temperature_range": {
"type": "string",
"example": "very_hot"
},
"wind_conditions": {
"type": "string",
"example": "no_wind"
}
}
}
}
},
"start_time_tbd": {
"type": "boolean",
"example": true,
"default": true
},
"status": {
"type": "string",
"example": "string"
},
"tour": {
"type": "object",
"properties": {
"category": {
"type": "object",
"properties": {
"country_code": {
"type": "string",
"example": "string"
},
"id": {
"type": "string",
"example": "string"
},
"name": {
"type": "string",
"example": "string"
}
}
},
"id": {
"type": "string",
"example": "string"
},
"name": {
"type": "string",
"example": "string"
},
"sport": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "string"
},
"name": {
"type": "string",
"example": "string"
}
}
}
}
},
"tournament": {
"type": "object",
"properties": {
"category": {
"type": "object",
"properties": {
"country_code": {
"type": "string",
"example": "string"
},
"id": {
"type": "string",
"example": "string"
},
"name": {
"type": "string",
"example": "string"
}
}
},
"current_season": {
"type": "object",
"properties": {
"end_date": {
"type": "string",
"example": "2026-08-04"
},
"id": {
"type": "string",
"example": "string"
},
"name": {
"type": "string",
"example": "string"
},
"start_date": {
"type": "string",
"example": "2026-08-04"
},
"year": {
"type": "string",
"example": "string"
}
}
},
"gender": {
"type": "string",
"example": "men"
},
"id": {
"type": "string",
"example": "string"
},
"name": {
"type": "string",
"example": "string"
},
"parent_id": {
"type": "string",
"example": "string"
},
"season_coverage_info": {
"type": "object",
"properties": {
"max_coverage_level": {
"type": "string",
"example": "string"
},
"max_covered": {
"type": "string",
"example": "string"
},
"min_coverage_level": {
"type": "string",
"example": "string"
},
"played": {
"type": "integer",
"example": 0,
"default": 0
},
"scheduled": {
"type": "integer",
"example": 0,
"default": 0
},
"season_id": {
"type": "string",
"example": "string"
}
}
},
"sport": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "string"
},
"name": {
"type": "string",
"example": "string"
}
}
},
"tour_id": {
"type": "string",
"example": "string"
},
"type": {
"type": "string",
"example": "test"
}
}
},
"tournament_round": {
"type": "object",
"properties": {
"competition_sport_event_number": {
"type": "integer",
"example": 0,
"default": 0
},
"cup_round_match_number": {
"type": "integer",
"example": 0,
"default": 0
},
"cup_round_matches": {
"type": "integer",
"example": 0,
"default": 0
},
"name": {
"type": "string",
"example": "string"
},
"number": {
"type": "integer",
"example": 0,
"default": 0
},
"other_match_id": {
"type": "string",
"example": "string"
},
"phase": {
"type": "string",
"example": "string"
},
"type": {
"type": "string",
"example": "string"
}
}
},
"venue": {
"type": "object",
"properties": {
"bowling_ends": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"example": "string"
}
}
}
},
"capacity": {
"type": "integer",
"example": 0,
"default": 0
},
"city_id": {
"type": "string",
"example": "string"
},
"city_name": {
"type": "string",
"example": "string"
},
"country_code": {
"type": "string",
"example": "string"
},
"country_name": {
"type": "string",
"example": "string"
},
"id": {
"type": "string",
"example": "string"
},
"map_coordinates": {
"type": "string",
"example": "string"
},
"name": {
"type": "string",
"example": "string"
},
"state": {
"type": "string",
"example": "string"
},
"timezone": {
"type": "string",
"example": "string"
}
}
}
}
}
},
"tournament": {
"type": "object",
"properties": {
"category": {
"type": "object",
"properties": {
"country_code": {
"type": "string",
"example": "string"
},
"id": {
"type": "string",
"example": "string"
},
"name": {
"type": "string",
"example": "string"
}
}
},
"current_season": {
"type": "object",
"properties": {
"end_date": {
"type": "string",
"example": "2026-08-04"
},
"id": {
"type": "string",
"example": "string"
},
"name": {
"type": "string",
"example": "string"
},
"start_date": {
"type": "string",
"example": "2026-08-04"
},
"year": {
"type": "string",
"example": "string"
}
}
},
"gender": {
"type": "string",
"example": "men"
},
"id": {
"type": "string",
"example": "string"
},
"name": {
"type": "string",
"example": "string"
},
"parent_id": {
"type": "string",
"example": "string"
},
"season_coverage_info": {
"type": "object",
"properties": {
"max_coverage_level": {
"type": "string",
"example": "string"
},
"max_covered": {
"type": "string",
"example": "string"
},
"min_coverage_level": {
"type": "string",
"example": "string"
},
"played": {
"type": "integer",
"example": 0,
"default": 0
},
"scheduled": {
"type": "integer",
"example": 0,
"default": 0
},
"season_id": {
"type": "string",
"example": "string"
}
}
},
"sport": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "string"
},
"name": {
"type": "string",
"example": "string"
}
}
},
"tour_id": {
"type": "string",
"example": "string"
},
"type": {
"type": "string",
"example": "test"
}
}
}
}
}
}
}
}
}
}
}
},
"x-readme": {
"headers": [],
"explorer-enabled": true,
"proxy-enabled": true
},
"x-readme-fauxas": true
}
```