---
updatedAt: 2025-09-18T19:23:11.000Z
agentTools:
siteIndex: https://developer.sportradar.com/llms.txt
projectIndex: https://developer.sportradar.com/odds/v1/llms.txt
---
# Team Mapping
Provides team ID mapping between League Specific and General Sport ID types.
### Update Frequency
600s Time To Live / Cache
***
## Data Points
| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `us_id` | `mapping` | String | Unique UUID of a team
ex. `2b175a09-f25b-43d5-84fc-cf7c47054557`
Click [here](https://developer.sportradar.com/getting-started/docs/id-types#primary-ids) for more info on Sportradar IDs |
| `id` | `mapping` | String | Unique SR ID of a team
ex. `sr:competitor:1954` |
# 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": "header",
"name": "x-api-key"
}
}
},
"security": [
{
"sec0": []
}
],
"paths": {
"/oddscomparison-{package_type}{access_level}1/{language_code}/{odds_format}/teams/id_mappings.{format}": {
"get": {
"summary": "Team Mapping",
"description": "Provides team ID mapping between League Specific and General Sport ID types.",
"operationId": "oc-regular-team-mapping",
"parameters": [
{
"name": "start",
"in": "query",
"description": "Number to start the list of results from. Example: start=0",
"schema": {
"type": "string"
}
},
{
"name": "package_type",
"in": "path",
"description": "Odds package type, with configured bookmakers prominent in either the US or global markets
`us` (United States), `row` (Rest of World)",
"schema": {
"type": "string",
"enum": [
"us",
"row"
],
"default": "us"
},
"required": true
},
{
"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": "limit",
"in": "query",
"description": "Number to limit the number of results. Minimum value is 1, maximum value is 30000. Example: limit=30000",
"schema": {
"type": "string"
}
},
{
"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": "odds_format",
"in": "path",
"description": "Odds type in 2-letter format
`us` (American), `uk` (Fractional), `eu` (Decimal)",
"schema": {
"type": "string",
"enum": [
"us",
"uk",
"eu"
],
"default": "us"
},
"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 \"generated_at\": \"2023-05-11T18:56:50+00:00\",\n \"schema\": \"https://schemas.sportradar.com/sportsapi/bsa/oddscomparison/v1/schemas/team_mappings.json\",\n \"team_mappings\": [\n {\n \"us_id\": \"2b175a09-f25b-43d5-84fc-cf7c47054557\",\n \"id\": \"sr:competitor:1954\"\n },\n {\n \"us_id\": \"5c84929b-17fa-40bc-9c27-507fd5ae4036\",\n \"id\": \"sr:competitor:1957\"\n },\n {\n \"us_id\": \"b54e0848-2662-4b11-b007-202289b31fea\",\n \"id\": \"sr:competitor:1958\"\n },\n {\n \"us_id\": \"881b7017-81e8-4f4a-97b2-9d2d7b307268\",\n \"id\": \"sr:competitor:1959\"\n },\n {\n \"us_id\": \"54bbf34b-3e18-46db-bedc-abb2241b7328\",\n \"id\": \"sr:competitor:1961\"\n },\n {\n \"us_id\": \"0182979b-a7b9-490e-916d-adee2b2ae34f\",\n \"id\": \"sr:competitor:1962\"\n },\n {\n \"us_id\": \"14340108-0a0f-4da6-8909-ab894dd30aaf\",\n \"id\": \"sr:competitor:1963\"\n },\n {\n \"us_id\": \"ffc193bf-12e9-4ca0-92ce-22df9ebab78d\",\n \"id\": \"sr:competitor:1966\"\n },\n {\n \"us_id\": \"c7343126-0da7-43c1-969b-7225b1c7d382\",\n \"id\": \"sr:competitor:1967\"\n },\n {\n \"us_id\": \"db560f1a-2ea3-4e9d-b63b-b26e75e90605\",\n \"id\": \"sr:competitor:905435\"\n }\n ]\n}"
}
},
"schema": {
"type": "object",
"properties": {
"generated_at": {
"type": "string",
"example": "2023-05-11T18:56:50+00:00"
},
"schema": {
"type": "string",
"example": "https://schemas.sportradar.com/sportsapi/bsa/oddscomparison/v1/schemas/team_mappings.json"
},
"team_mappings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"us_id": {
"type": "string",
"example": "2b175a09-f25b-43d5-84fc-cf7c47054557"
},
"id": {
"type": "string",
"example": "sr:competitor:1954"
}
}
}
}
}
}
}
}
}
},
"deprecated": false
}
}
},
"x-readme": {
"headers": [],
"explorer-enabled": true,
"proxy-enabled": true
},
"x-readme-fauxas": true
}
```