---
updatedAt: 2026-07-28T08:19:21.000Z
agentTools:
siteIndex: https://developer.sportradar.com/llms.txt
projectIndex: https://developer.sportradar.com/tennis/llms.txt
---
# Doubles Competitions Played
Returns doubles competitions played and the partners a competitor played
with.
### Update Frequency
**TTL/Cache:** 300 seconds
**Data Updates (Tier 1):** Player Data check two weeks before competition start
> 📘 Displaying Rankings
>
> Learn how doubles team data connects to rankings displays in our [Retrieving Rankings and Standings](https://developer.sportradar.com/tennis/docs/tennis-ig-leaderboards-rankings-standings) integration scenario.
***
## Data Points
| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `gender` | `competition` | String | Gender for a competition
`men`, `women`, `mixed`, `female`, `male` |
| `id` | `competition` | String | Unique ID for a competition
ex. `sr:competition:2555` (Wimbledon Men Singles) |
| `level` | `competition` | String | Level of a competition
`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
ex. `Wimbledon Men Singles`, `WTA Monterrey, Mexico Women Doubles` |
| `parent_id` | `competition` | String | Unique parent ID for a competition.
ex. `sr:competition:2553` is used to group all Wimbledon competitions. |
| `type` | `competition` | String | Type of a competition
ex. `singles`, `doubles`, `mixed`, `mixed_doubles` |
> Competitors can be a player, a doubles team, or a national team
| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `abbreviation` | `competitors` - `competitor` | String | Abbreviation for a competitor name
ex. `PAU` (Tommy Paul) or `G/M` ('Glasspool L / Middelkoop M' doubles team) |
| `country` | `competitors` - `competitor` | String | Country of a competitor
ex. `USA` |
| `gender` | `competitors` - `competitor` | String | Gender for a competitor
`male`, `female`, `mixed` |
| `id` | `competitors` - `competitor` | String | Unique ID for a competitor
ex. `sr:competitor:670029` |
| `name` | `competitors` - `competitor` | String | Name for a competitor
ex. `Paul, Tommy` or `Glasspool L / Middelkoop M` (doubles team) |
> Competitors will appear under a `players` node when part of a doubles competition.
| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `abbreviation` | `competitor` - `players` - `player` | String | Abbreviation for a competitor name
ex. `PAU` (Tommy Paul) |
| `country` | `competitor` - `players` - `player` | String | Country of a competitor
ex. `USA` |
| `gender` | `competitor` - `players` - `player` | String | Gender for a competitor
`male`, `female` |
| `id` | `competitor` - `players` - `player` | String | Unique ID for a competitor
ex. `sr:competitor:138546` |
| `name` | `competitor` - `players` - `player` | String | Name for a competitor
ex. `Paul, Tommy` |
# 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}/competitors/{competitor_id}/doubles_competitions_played.{format}": {
"get": {
"summary": "Doubles Competitions Played",
"description": "Returns doubles competitions played and the partners a competitor played\nwith.",
"operationId": "doubles-competitions-played",
"parameters": [
{
"name": "access_level",
"in": "path",
"description": "The access level of your API key
`trial`, `production`",
"schema": {
"type": "string",
"enum": [
"trial",
"production"
],
"default": "trial"
},
"required": true
},
{
"name": "language_code",
"in": "path",
"description": "Language code for supported languages.
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)
The above codes are the fully supported languages 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",
"enum": [
"de",
"en",
"en_us",
"es",
"fr",
"id",
"it",
"ja",
"ru",
"th",
"zh",
"zht"
],
"default": "en"
},
"required": true
},
{
"name": "competitor_id",
"in": "path",
"description": "Unique Id of a competitor (player)
**Example:** `sr:competitor:89320`",
"schema": {
"type": "string",
"default": "sr:competitor:89320"
},
"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 \"competitions\": [\n {\n \"competitors\": [\n {\n \"abbreviation\": \"string\",\n \"bracket_number\": 0,\n \"country\": \"string\",\n \"country_code\": \"string\",\n \"gender\": \"female\",\n \"id\": \"string\",\n \"name\": \"string\",\n \"players\": [\n {\n \"abbreviation\": \"string\",\n \"country\": \"string\",\n \"country_code\": \"string\",\n \"date_of_birth\": \"2023-04-26\",\n \"gender\": \"female\",\n \"height\": 0,\n \"id\": \"string\",\n \"name\": \"string\",\n \"nationality\": \"string\",\n \"weight\": 0\n }\n ],\n \"qualifier\": \"string\",\n \"seed\": 0,\n \"virtual\": true\n }\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:26:43.817Z\"\n}"
}
},
"schema": {
"type": "object",
"properties": {
"competitions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"competitors": {
"type": "array",
"items": {
"type": "object",
"properties": {
"abbreviation": {
"type": "string",
"example": "string"
},
"bracket_number": {
"type": "integer",
"example": 0,
"default": 0
},
"country": {
"type": "string",
"example": "string"
},
"country_code": {
"type": "string",
"example": "string"
},
"gender": {
"type": "string",
"example": "female"
},
"id": {
"type": "string",
"example": "string"
},
"name": {
"type": "string",
"example": "string"
},
"players": {
"type": "array",
"items": {
"type": "object",
"properties": {
"abbreviation": {
"type": "string",
"example": "string"
},
"country": {
"type": "string",
"example": "string"
},
"country_code": {
"type": "string",
"example": "string"
},
"date_of_birth": {
"type": "string",
"example": "2023-04-26"
},
"gender": {
"type": "string",
"example": "female"
},
"height": {
"type": "integer",
"example": 0,
"default": 0
},
"id": {
"type": "string",
"example": "string"
},
"name": {
"type": "string",
"example": "string"
},
"nationality": {
"type": "string",
"example": "string"
},
"weight": {
"type": "integer",
"example": 0,
"default": 0
}
}
}
},
"qualifier": {
"type": "string",
"example": "string"
},
"seed": {
"type": "integer",
"example": 0,
"default": 0
},
"virtual": {
"type": "boolean",
"example": true,
"default": true
}
}
}
},
"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:26:43.817Z"
}
}
}
}
}
}
}
}
}
},
"x-readme": {
"headers": [],
"explorer-enabled": true,
"proxy-enabled": true
},
"x-readme-fauxas": true
}
```