---
updatedAt: 2025-09-25T19:30:57.000Z
agentTools:
  siteIndex: https://developer.sportradar.com/llms.txt
  projectIndex: https://developer.sportradar.com/cricket/llms.txt
---

# Tournament Info

Provides information for a given tournament or season, including current season, participating teams, and tournament structure.

<Callout icon="⏱️" theme="default">
  ### Update Frequency

  60s Time To Live / Cache
</Callout>

***

## Data Points

<Accordion title="Tournament" icon="fa-light fa-cricket-bat-ball">
  | Attribute | Parent Element | Type   | Description                                                                                                 |
  | --------- | -------------- | ------ | ----------------------------------------------------------------------------------------------------------- |
  | `gender`  | `tournament`   | String | Gender of a tournament<br /><br />`men`, `women`, `mixed`                                                   |
  | `id`      | `tournament`   | String | Unique ID for a tournament<br /><br />ex. `sr:tournament:21568` (Sheffield Shield)                          |
  | `name`    | `tournament`   | String | Name of a tournament<br /><br />ex. `Sheffield Shield`                                                      |
  | `type`    | `tournament`   | String | Type of a tournament<br /><br />`test`, `odi`, `t10`, `t20i`, `first_class`, `list_a`, `t20`, `the_hundred` |
</Accordion>

<Accordion title="Category & Sport" icon="fa-light fa-cricket-bat-ball">
  | Attribute      | Parent Element            | Type   | Description                                                          |
  | -------------- | ------------------------- | ------ | -------------------------------------------------------------------- |
  | `country_code` | `tournament` - `category` | String | Country code for a tournament's category                             |
  | `id`           | `tournament` - `category` | String | Unique category ID for a tournament<br /><br />ex. `sr:category:105` |
  | `name`         | `tournament` - `category` | String | Name for a tournament's category<br /><br />ex. `International`      |
  | `id`           | `tournament` - `sport`    | String | Unique sport ID for a tournament<br /><br />ex. `sr:sport:21`        |
  | `name`         | `tournament` - `sport`    | String | Name for a tournament's sport<br /><br />ex. `Cricket`               |
</Accordion>

<Accordion title="Current Season" icon="fa-light fa-cricket-bat-ball">
  | Attribute    | Parent Element                  | Type   | Description                                                                                            |
  | ------------ | ------------------------------- | ------ | ------------------------------------------------------------------------------------------------------ |
  | `end_date`   | `tournament` - `current_season` | Date   | End date of a tournament's current season<br /><br />ex. `2024-06-17`                                  |
  | `id`         | `tournament` - `current_season` | String | Unique ID for a tournament's current season<br /><br />ex. `sr:season:122977` (Sheffield Shield 24/25) |
  | `name`       | `tournament` - `current_season` | String | Name of a tournament's current season<br /><br />ex. `Sheffield Shield 24/25`                          |
  | `start_date` | `tournament` - `current_season` | Date   | Start date of a tournament's current season<br /><br />ex. `2023-09-23`                                |
  | `year`       | `tournament` - `current_season` | String | Year of a tournament's current season<br /><br />ex. `23/24` or `2024`                                 |
</Accordion>

<Accordion title="Competitors" icon="fa-light fa-cricket-bat-ball">
  | Attribute      | Parent Element   | Type   | Description                                                                         |
  | -------------- | ---------------- | ------ | ----------------------------------------------------------------------------------- |
  | `abbreviation` | `group` - `team` | String | Abbreviation for a competitor name<br /><br />ex. `BUL` (Queensland Bulls)          |
  | `country`      | `group` - `team` | String | Country of a competitor<br /><br />ex. `Australia`                                  |
  | `country_code` | `group` - `team` | String | Country code of a competitor<br /><br />ex. `AUS` (Australia)                       |
  | `gender`       | `group` - `team` | String | Gender for a competitor<br /><br />`male`, `female`                                 |
  | `id`           | `group` - `team` | String | Unique ID for a competitor<br /><br />ex. `sr:competitor:142678` (Queensland Bulls) |
  | `name`         | `group` - `team` | String | Name for a competitor<br /><br />ex. `Queensland Bulls`                             |
</Accordion>

# 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}/info.{format}": {
      "get": {
        "summary": "Tournament Info",
        "description": "Provides information for a given tournament or season, including current season, participating teams, and tournament structure.",
        "operationId": "cricket-tournament-info",
        "parameters": [
          {
            "name": "access_level",
            "in": "path",
            "description": "The access level of your API key<br><br>`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<br><br>`en` (English)<br><br>English is the only fully supported language for this API. Click <span style=\"text-decoration:underline\">[here](https://api-docs.sportradar.us/misc/Sportradar_API_Languages.xlsx)</span> 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 <span style=\"text-decoration:underline\">[Tournament List](https://developer.sportradar.com/cricket/reference/cricket-tournament-list)</span> endpoint<br><br>**Example:** `sr:tournament:2472` or `sr:season:119197`",
            "schema": {
              "type": "string",
              "default": "sr:tournament:2472"
            },
            "required": true
          },
          {
            "name": "format",
            "in": "path",
            "description": "Format returned<br><br>`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\": \"2024-01-17T21:56:55.259Z\",\n  \"groups\": [\n    {\n      \"name\": \"string\",\n      \"teams\": [\n        {\n          \"abbreviation\": \"string\",\n          \"age_group\": \"U23\",\n          \"category\": {\n            \"country_code\": \"string\",\n            \"id\": \"string\",\n            \"name\": \"string\"\n          },\n          \"country\": \"string\",\n          \"country_code\": \"string\",\n          \"gender\": \"string\",\n          \"id\": \"string\",\n          \"ioc_code\": \"string\",\n          \"name\": \"string\",\n          \"qualifier\": \"home\",\n          \"sport\": {\n            \"id\": \"string\",\n            \"name\": \"string\"\n          },\n          \"virtual\": true\n        }\n      ]\n    }\n  ],\n  \"tournament\": {\n    \"category\": {\n      \"country_code\": \"string\",\n      \"id\": \"string\",\n      \"name\": \"string\"\n    },\n    \"current_season\": {\n      \"end_date\": \"2024-01-17\",\n      \"id\": \"string\",\n      \"name\": \"string\",\n      \"start_date\": \"2024-01-17\",\n      \"year\": \"string\"\n    },\n    \"gender\": \"men\",\n    \"id\": \"string\",\n    \"name\": \"string\",\n    \"parent_id\": \"string\",\n    \"season_coverage_info\": {\n      \"max_coverage_level\": \"string\",\n      \"max_covered\": \"string\",\n      \"min_coverage_level\": \"string\",\n      \"played\": 0,\n      \"scheduled\": 0,\n      \"season_id\": \"string\"\n    },\n    \"sport\": {\n      \"id\": \"string\",\n      \"name\": \"string\"\n    },\n    \"tour_id\": \"string\",\n    \"type\": \"test\"\n  }\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "generated_at": {
                      "type": "string",
                      "example": "2024-01-17T21:56:55.259Z"
                    },
                    "groups": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "name": {
                            "type": "string",
                            "example": "string"
                          },
                          "teams": {
                            "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
                                }
                              }
                            }
                          }
                        }
                      }
                    },
                    "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": "2024-01-17"
                            },
                            "id": {
                              "type": "string",
                              "example": "string"
                            },
                            "name": {
                              "type": "string",
                              "example": "string"
                            },
                            "start_date": {
                              "type": "string",
                              "example": "2024-01-17"
                            },
                            "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"
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```