---
updatedAt: 2025-09-18T19:23:46.000Z
agentTools:
  siteIndex: https://developer.sportradar.com/llms.txt
  projectIndex: https://developer.sportradar.com/odds/v1/llms.txt
---

# Tournament Mapping

Provides tournament ID mapping between League Specific and General Sport ID types.

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

  600s Time To Live / Cache
</Callout>

***

## Data Points

<Accordion title="Mapping" icon="fa-light fa-chart-simple-horizontal">
  | Attribute | Parent Element | Type   | Description                                                                                                                                                                                                           |
  | --------- | -------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `us_id`   | `mapping`      | String | Unique UUID of a tournament<br /><br />ex. `fdc32c0e-2a6a-4bbe-b855-41fef6369bfe`<br /><br />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 tournament<br /><br />ex. `sr:tournament:17`                                                                                                                                                        |
</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": "header",
        "name": "x-api-key"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/oddscomparison-{package_type}{access_level}1/{language_code}/{odds_format}/tournaments/id_mappings.{format}": {
      "get": {
        "summary": "Tournament Mapping",
        "description": "Provides tournament ID mapping between League Specific and General Sport ID types.",
        "operationId": "oc-regular-tournament-mapping",
        "parameters": [
          {
            "name": "package_type",
            "in": "path",
            "description": "Odds package type, with configured bookmakers prominent in either the US or global markets<br><br>`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<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": "odds_format",
            "in": "path",
            "description": "Odds type in 2-letter format<br><br>`us` (American), `uk` (Fractional), `eu` (Decimal)",
            "schema": {
              "type": "string",
              "enum": [
                "us",
                "uk",
                "eu"
              ],
              "default": "us"
            },
            "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\": \"2023-05-11T18:57:36+00:00\",\n    \"schema\": \"https://schemas.sportradar.com/sportsapi/bsa/oddscomparison/v1/schemas/tournament_mappings.json\",\n    \"tournament_mappings\": [\n        {\n            \"us_id\": \"5d65bd76-7547-4693-99cd-33e2dc3c30f2\",\n            \"id\": \"sr:tournament:28843\"\n        },\n        {\n            \"us_id\": \"b9a5a65b-f098-48e7-b9a3-a3fbd1d47b72\",\n            \"id\": \"sr:tournament:28731\"\n        },\n        {\n            \"us_id\": \"1a4257b1-a86a-4bd3-94ad-56b88334f6de\",\n            \"id\": \"sr:tournament:24393\"\n        },\n        {\n            \"us_id\": \"4a75a4ed-463f-4403-81c7-76ca97f8509e\",\n            \"id\": \"sr:tournament:34080\"\n        },\n        {\n            \"us_id\": \"c3588c5e-505e-4248-a70a-9f941d5681b5\",\n            \"id\": \"sr:tournament:24798\"\n        },\n        {\n            \"us_id\": \"e4b55b5b-854f-4e1c-80f9-3c9049151290\",\n            \"id\": \"sr:tournament:28191\"\n        },\n        {\n            \"us_id\": \"bfed5fed-40d9-4d0c-a6be-a689ba25a7ec\",\n            \"id\": \"sr:tournament:27278\"\n        },\n        {\n            \"us_id\": \"30a39a35-d177-40e9-b9bc-a9f902c684e3\",\n            \"id\": \"sr:tournament:32031\"\n        },\n        {\n            \"us_id\": \"dad58e15-9fab-49a5-a1e3-ea520f764698\",\n            \"id\": \"sr:tournament:23787\"\n        },\n        {\n            \"us_id\": \"bc61b9e3-e054-496b-bcb7-4756a0490c51\",\n            \"id\": \"sr:tournament:31739\"\n        },\n        {\n            \"us_id\": \"ea86ac27-8e64-48bd-a578-e1d263f98d6b\",\n            \"id\": \"sr:tournament:1690\"\n        },\n        {\n            \"us_id\": \"4f96580d-8480-4c14-af04-fd4afc069656\",\n            \"id\": \"sr:tournament:1848\"\n        }\n    ]\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "generated_at": {
                      "type": "string",
                      "example": "2023-05-11T18:57:36+00:00"
                    },
                    "schema": {
                      "type": "string",
                      "example": "https://schemas.sportradar.com/sportsapi/bsa/oddscomparison/v1/schemas/tournament_mappings.json"
                    },
                    "tournament_mappings": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "us_id": {
                            "type": "string",
                            "example": "5d65bd76-7547-4693-99cd-33e2dc3c30f2"
                          },
                          "id": {
                            "type": "string",
                            "example": "sr:tournament:28843"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```