---
updatedAt: 2026-07-28T08:19:07.000Z
agentTools:
  siteIndex: https://developer.sportradar.com/llms.txt
  projectIndex: https://developer.sportradar.com/tennis/llms.txt
---

# Competitions

Displays all competitions.

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

  **TTL/Cache:** 300s

  **Data Updates (Tier 1):** Tournaments added at the end of the previous season
</Callout>

> 📘 Loading the Competition Catalog
>
> Learn how to use the Competitions feed to discover tournaments and collect competition IDs in our [Pulling Schedules](https://developer.sportradar.com/tennis/docs/tennis-ig-schedules) integration scenario.

***

## Data Points

<Accordion title="Category & Sport" icon="fa-thin fa-tennis-ball">

| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `country_code` | `competition` - `category` | String | Country code for a competition category   |
| `id`  | `competition` - `category` | String | Unique category ID for a competition. See our [FAQ](https://developer.sportradar.com/tennis/reference/faq#what-are-the-available-categoriestours) for a list of available categories/tours.<br /><br />ex. `sr:category:3` (ATP) |
| `name`   | `competition` - `category` | String | Name for a competition category. See our [FAQ](https://developer.sportradar.com/tennis/reference/faq#what-are-the-available-categoriestours) for a list of available categories/tours.<br /><br />ex. `ATP`, `WTA`, `Billie Jean King Cup` |

</Accordion>

<Accordion title="Competition" icon="fa-thin fa-tennis-ball">

| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `gender` | `competition`  | String | Gender for a competition<br /><br />`men`, `women`, `mixed`, `female`, `male`  |
| `id`  | `competition`  | String | Unique ID for a competition<br /><br />ex. `sr:competition:2555` (Wimbledon Men Singles) |
| `level`  | `competition`  | String | Level of a competition<br /><br />`grand_slam`, `atp_1000`, `atp_500`, `atp_250`, `wta_premier`, `wta_international`, `atp_world_tour_finals`, `wta_championships`, `atp_next_generation`, `wta_elite_trophy`, `wta_master`, `wta_500`, `wta_250`, `wta_1000`, `wta_125` |
| `name`   | `competition`  | String | Name of a competition<br /><br />ex. `Wimbledon Men Singles`, `WTA Monterrey, Mexico Women Doubles` |
| `parent_id` | `competition`  | String | Unique parent ID for a competition.<br /><br />ex. `sr:competition:2553` is used to group all Wimbledon competitions. |
| `type`   | `competition`  | String | Type of a competition<br /><br />ex. `singles`, `doubles`, `mixed`, `mixed_doubles` |

</Accordion>

<br />

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "tennis",
    "version": "3"
  },
  "servers": [
    {
      "url": "https://api.sportradar.com/tennis"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "in": "header",
        "name": "x-api-key"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/{access_level}/v3/{language_code}/competitions.{format}": {
      "get": {
        "summary": "Competitions",
        "description": "Displays all competitions.",
        "operationId": "competitions",
        "parameters": [
          {
            "name": "access_level",
            "in": "path",
            "description": "The access level of your API key<br><br>`trial`, `production`",
            "schema": {
              "type": "string",
              "enum": [
                "trial",
                "production"
              ],
              "default": "trial"
            },
            "required": true
          },
          {
            "name": "language_code",
            "in": "path",
            "description": "Language code for supported languages.<br><br>de (German), en (English), en_us (English with diacritical marks in player names), es (Spanish), fr (French), id (Indonesian), it (Italian), ja (Japanese), ru (Russian), th (Thai), zh (Chinese - simplified), zht (Chinese - traditional)<br><br>The above codes are the fully supported languages 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",
              "enum": [
                "de",
                "en",
                "en_us",
                "es",
                "fr",
                "id",
                "it",
                "ja",
                "ru",
                "th",
                "zh",
                "zht"
              ],
              "default": "en"
            },
            "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  \"competitions\": [\n    {\n      \"category\": {\n        \"country_code\": \"string\",\n        \"id\": \"string\",\n        \"name\": \"string\"\n      },\n      \"gender\": \"string\",\n      \"id\": \"string\",\n      \"level\": \"grand_slam\",\n      \"name\": \"string\",\n      \"parent_id\": \"string\",\n      \"type\": \"string\"\n    }\n  ],\n  \"generated_at\": \"2023-04-26T18:20:01.822Z\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "competitions": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "category": {
                            "type": "object",
                            "properties": {
                              "country_code": {
                                "type": "string",
                                "example": "string"
                              },
                              "id": {
                                "type": "string",
                                "example": "string"
                              },
                              "name": {
                                "type": "string",
                                "example": "string"
                              }
                            }
                          },
                          "gender": {
                            "type": "string",
                            "example": "string"
                          },
                          "id": {
                            "type": "string",
                            "example": "string"
                          },
                          "level": {
                            "type": "string",
                            "example": "grand_slam"
                          },
                          "name": {
                            "type": "string",
                            "example": "string"
                          },
                          "parent_id": {
                            "type": "string",
                            "example": "string"
                          },
                          "type": {
                            "type": "string",
                            "example": "string"
                          }
                        }
                      }
                    },
                    "generated_at": {
                      "type": "string",
                      "example": "2023-04-26T18:20:01.822Z"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```