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

# Venue Mapping

Provides venue 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 venue<br /><br />ex. `0ecb64e4-430a-4882-897c-4fc06aff179b`<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 venue<br /><br />ex. `sr:venue:8069`                                                                                                                                                           |
</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}/venues/id_mappings.{format}": {
      "get": {
        "summary": "Venue Mapping",
        "description": "Provides venue ID mapping between League Specific and General Sport ID types.",
        "operationId": "oc-regular-venue-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-11T19:01:30+00:00\",\n    \"schema\": \"https://schemas.sportradar.com/sportsapi/bsa/oddscomparison/v1/schemas/venue_mappings.json\",\n    \"venue_mappings\": [\n        {\n            \"us_id\": \"010c72f0-ef3d-11ed-bc8c-3bdceca0704b\",\n            \"id\": \"sr:venue:67707\"\n        },\n        {\n            \"us_id\": \"fd507ab0-d314-11ed-a3f3-c98ec0329ec5\",\n            \"id\": \"sr:venue:18423\"\n        },\n        {\n            \"us_id\": \"3064a6b0-d315-11ed-aa43-db5636893d74\",\n            \"id\": \"sr:venue:1822\"\n        },\n        {\n            \"us_id\": \"3730d31f-87a0-468f-97bc-b3c80f925fbf\",\n            \"id\": \"sr:venue:70977\"\n        },\n        {\n            \"us_id\": \"df36924b-6f21-4460-bfb6-1d7bd154a632\",\n            \"id\": \"sr:venue:70977\"\n        },\n        {\n            \"us_id\": \"440c73b7-96a3-493b-aca1-ad24c158e1ad\",\n            \"id\": \"sr:venue:70735\"\n        },\n        {\n            \"us_id\": \"6a3d2d17-3412-4251-95fe-b3fff4a90cb9\",\n            \"id\": \"sr:venue:70737\"\n        },\n        {\n            \"us_id\": \"1c5db5ab-5da3-4707-b198-4588508686f2\",\n            \"id\": \"sr:venue:7560\"\n        },\n        {\n            \"us_id\": \"e0ed58e4-f9d6-4970-a6a3-929782fda04c\",\n            \"id\": \"sr:venue:70573\"\n        },\n        {\n            \"us_id\": \"a1fc5386-8d3e-4b6d-a572-7fa17601f49f\",\n            \"id\": \"sr:venue:70573\"\n        },\n        {\n            \"us_id\": \"a0156fcb-bf9f-4068-aac8-42f29d745b0a\",\n            \"id\": \"sr:venue:18229\"\n        },\n        {\n            \"us_id\": \"0eab9d5c-d3c3-4dc5-9ea0-4bb64a548b97\",\n            \"id\": \"sr:venue:18245\"\n        },\n        {\n            \"us_id\": \"f824b20c-8b1b-4c27-95a6-00ef48e3039c\",\n            \"id\": \"sr:venue:18349\"\n        },\n        {\n            \"us_id\": \"287e80f9-b537-4286-a310-557903b0ffbb\",\n            \"id\": \"sr:venue:18369\"\n        }\n    ]\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "generated_at": {
                      "type": "string",
                      "example": "2023-05-11T19:01:30+00:00"
                    },
                    "schema": {
                      "type": "string",
                      "example": "https://schemas.sportradar.com/sportsapi/bsa/oddscomparison/v1/schemas/venue_mappings.json"
                    },
                    "venue_mappings": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "us_id": {
                            "type": "string",
                            "example": "010c72f0-ef3d-11ed-bc8c-3bdceca0704b"
                          },
                          "id": {
                            "type": "string",
                            "example": "sr:venue:67707"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```