---
updatedAt: 2025-12-05T19:06:01.000Z
agentTools:
siteIndex: https://developer.sportradar.com/llms.txt
projectIndex: https://developer.sportradar.com/odds/v1/llms.txt
---
# Sport Event Mapping
Provides sport event ID mapping between League Specific and General Sport ID types.
### Update Frequency
**TTL / Cache:** 600 seconds
**Data Updates:** Mapping entries appear 14 days prior to an event, if odds are available
***
## Data Points
| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `us_id` | `mapping` | String | Unique UUID of a sport event
ex. `190d2515-dec4-44b7-a443-cf512356b080`
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 sport event
ex. `sr:match:46681021` |
# 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}/sport_events/id_mappings.{format}": {
"get": {
"summary": "Sport Event Mapping",
"description": "Provides sport event ID mapping between League Specific and General Sport ID types.",
"operationId": "oc-regular-sport-event-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:52:24+00:00\",\n \"schema\": \"https://schemas.sportradar.com/sportsapi/bsa/oddscomparison/v1/schemas/sport_event_mappings.json\",\n \"sport_event_mappings\": [\n {\n \"us_id\": \"176e6e0b-e22f-40f9-82f7-59ca85ae5006\",\n \"id\": \"sr:match:38061977\"\n },\n {\n \"us_id\": \"80b340c5-c771-4203-8a5f-5094c8142796\",\n \"id\": \"sr:match:38061997\"\n },\n {\n \"us_id\": \"4702ac25-8907-4a28-8594-97dcb595853a\",\n \"id\": \"sr:match:38062001\"\n },\n {\n \"us_id\": \"5feeffdc-48d5-44b7-9be7-c9c73c5c0353\",\n \"id\": \"sr:match:38062021\"\n },\n {\n \"us_id\": \"0ef8f496-f58c-4eec-b126-9fddd963123b\",\n \"id\": \"sr:match:38062037\"\n },\n {\n \"us_id\": \"7e6b3e6b-7608-47f5-94fa-2a7515b42419\",\n \"id\": \"sr:match:38062053\"\n },\n {\n \"us_id\": \"7ac1a5b0-83e8-44f0-8365-0007efbb1616\",\n \"id\": \"sr:match:38062065\"\n },\n {\n \"us_id\": \"6097ac03-c1df-4dd1-8271-4f75394ed06b\",\n \"id\": \"sr:match:38062093\"\n },\n {\n \"us_id\": \"7da7efb2-10c0-403b-872d-c2b84ed0c481\",\n \"id\": \"sr:match:38062097\"\n },\n {\n \"us_id\": \"2aaae82c-34f8-4748-a214-270fd2f319a7\",\n \"id\": \"sr:match:38062109\"\n },\n {\n \"us_id\": \"27a4bd14-ed19-4a5c-824d-02e1bca62ef9\",\n \"id\": \"sr:match:38062113\"\n },\n {\n \"us_id\": \"46c6f581-659b-4637-91d4-b47caccd73ce\",\n \"id\": \"sr:match:38062121\"\n },\n {\n \"us_id\": \"1e3fc38b-6d07-4145-90bf-a75d9dbf17ac\",\n \"id\": \"sr:match:38062139\"\n },\n {\n \"us_id\": \"059bcf87-e21b-4274-93d8-88e6668083be\",\n \"id\": \"sr:match:38062141\"\n },\n {\n \"us_id\": \"50fa0d83-1b9b-4c24-a2b3-fdea89ef9f67\",\n \"id\": \"sr:match:38062151\"\n },\n {\n \"us_id\": \"02608746-d832-47d1-a4b8-ff6f832bda70\",\n \"id\": \"sr:match:38062159\"\n },\n {\n \"us_id\": \"0489efab-6599-41be-80ff-76793e95b38e\",\n \"id\": \"sr:match:38062167\"\n },\n {\n \"us_id\": \"08ea94dd-8fbf-4043-bca1-e6c1b7de09a3\",\n \"id\": \"sr:match:38062175\"\n },\n {\n \"us_id\": \"74b91bc2-d840-4354-8917-0ae939a2c0b2\",\n \"id\": \"sr:match:38062179\"\n },\n {\n \"us_id\": \"23fdd76c-3870-481c-a298-6dd22b226ec8\",\n \"id\": \"sr:match:38062191\"\n }\n ]\n}"
}
},
"schema": {
"type": "object",
"properties": {
"generated_at": {
"type": "string",
"example": "2023-05-11T18:52:24+00:00"
},
"schema": {
"type": "string",
"example": "https://schemas.sportradar.com/sportsapi/bsa/oddscomparison/v1/schemas/sport_event_mappings.json"
},
"sport_event_mappings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"us_id": {
"type": "string",
"example": "176e6e0b-e22f-40f9-82f7-59ca85ae5006"
},
"id": {
"type": "string",
"example": "sr:match:38061977"
}
}
}
}
}
}
}
}
}
},
"deprecated": false
}
}
},
"x-readme": {
"headers": [],
"explorer-enabled": true,
"proxy-enabled": true
},
"x-readme-fauxas": true
}
```