---
updatedAt: 2026-07-28T07:49:35.000Z
agentTools:
siteIndex: https://developer.sportradar.com/llms.txt
projectIndex: https://developer.sportradar.com/soccer/llms.txt
---
# Competitor Mappings
**Soccer Extended Competitor Mappings** provides competitor id mapping between previous versions of the Soccer API.
### Update Frequency
300s Time To Live / Cache
> 📘 Resolving IDs Across Products
>
> Learn how to use Competitor Mappings to connect team IDs across Sportradar products in our [ID Handling](https://developer.sportradar.com/soccer/docs/soccer-ig-id-handling) guide.
***
## Data Points
| Attribute | Parent Element | Type | Description |
| ------------- | -------------- | ------ | ------------------------------------------------------------------------------------------ |
| `external_id` | `mapping` | String | Unique League Specific ID of a competitor
ex. `48afd607-eda9-4db8-9125-380bc78612d2` |
| `id` | `mapping` | String | Unique General Sport ID of a competitor
ex. `sr:competitor:44` |
# OpenAPI definition
```json
{
"openapi": "3.1.0",
"info": {
"title": "soccer-extended",
"version": "4"
},
"servers": [
{
"url": "https://api.sportradar.com/soccer-extended/"
}
],
"components": {
"securitySchemes": {
"sec0": {
"type": "apiKey",
"in": "header",
"name": "x-api-key"
}
}
},
"security": [
{
"sec0": []
}
],
"paths": {
"/{access_level}/v4/{language_code}/competitors/mappings.{format}": {
"get": {
"summary": "Competitor Mappings",
"description": "**Soccer Extended Competitor Mappings** provides competitor id mapping between previous versions of the Soccer API.",
"operationId": "soccer-extended-competitor-mappings",
"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": "2-letter code for supported languages
`da` (Danish), `de` (German), `el` (Greek), `en` (English), `es` (Spanish), `fi` (Finnish), `fr` (French), `id` (Indonesian), `it` (Italian), `ja` (Japanese), `nl` (Dutch), `pt` (Portuguese), `ru` (Russian), `sr` (Serbian), `srl` (Serbian Latin), `th` (Thai), `tr` (Turkish), `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": [
"da",
"de",
"el",
"en",
"es",
"fi",
"fr",
"id",
"it",
"ja",
"nl",
"pt",
"ru",
"sr",
"srl",
"th",
"tr",
"zh",
"zht"
],
"default": "en"
},
"required": true
},
{
"name": "format",
"in": "path",
"description": "Format returned
`json`, `xml`",
"schema": {
"type": "string",
"enum": [
"json",
"xml"
],
"default": "json"
},
"required": true
},
{
"name": "start",
"in": "query",
"description": "The number of items to skip before starting to collect the result set.
Default: `0`
Example: `start=1000` to receive a 2nd page of results (if necessary)
Note: You may alternatively use `offset`",
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "limit",
"in": "query",
"description": "The number of items to return.
Maximum: `1000`
Default value: `1000`
Example: `limit=200`
**Note**: Pagination will often be required to pull all data within this feed. By default, the feed will return 1,000 competitor mappings.",
"schema": {
"type": "integer",
"format": "int32"
}
}
],
"responses": {
"200": {
"description": "200",
"content": {
"application/json": {
"examples": {
"Result": {
"value": "{\n \"generated_at\": \"2023-04-20T21:07:53.072Z\",\n \"mappings\": [\n {\n \"external_id\": \"string\",\n \"id\": \"string\",\n \"merged_id\": \"string\",\n \"retained_id\": \"string\"\n }\n ]\n}"
}
},
"schema": {
"type": "object",
"properties": {
"generated_at": {
"type": "string",
"example": "2023-04-20T21:07:53.072Z"
},
"mappings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"external_id": {
"type": "string",
"example": "string"
},
"id": {
"type": "string",
"example": "string"
},
"merged_id": {
"type": "string",
"example": "string"
},
"retained_id": {
"type": "string",
"example": "string"
}
}
}
}
}
}
}
}
}
}
}
}
},
"x-readme": {
"headers": [],
"explorer-enabled": true,
"proxy-enabled": true
},
"x-readme-fauxas": true
}
```