BET Utility API | Engagement Tools | Sportradar Developer Documentation

The BET Utility API provides comprehensive sport entity information from Sportradar, including sports, tournaments, seasons, and fixtures. Use this data to:

Initialize BET widgets with accurate entity IDs
Create direct links to hosted solutions
Map between Sportradar and client sport entity IDs
Build custom sport data integrations

info

The BET Utility API is part of Sportradar's Sports API. For general information about authentication, pagination, and getting started, visit the Sportradar Developer Portal.

#Available APIs

Two APIs are currently available:

Coverage API - Sport entity data (sports, competitions, seasons, fixtures)
Mapping API - Match ID mapping between Sportradar and client systems

#Coverage API

The Coverage API provides sport entity data, including sport, competition, season, and fixture information. Use this data for:

BET product initialization
Generating hosted product links
Implementing entity ID mappings on the client side

note

This API replaces Sportradar's legacy MDP matchTree API.

#Sport Hierarchy Types

Sportradar uses two different sport hierarchy structures:

Competition → Season → Fixture

Most sports use this traditional hierarchy, including:

Soccer

#Endpoints

#Sports

text

GET https://api.sportradar.com/bet-coverage/v1/en/sports.json

Returns a list of all available sports with their IDs and hierarchy types. Sport IDs are required for other endpoint requests.

View Request Example

text

https://api.sportradar.com/bet-coverage/v1/en/sports.json?api_key={apiKey}

View Response Example

json

{
    "generated_at": "2025-07-07T09:19:33+00:00",
    "sports": [
        {
            "id": "sr:sport:1",
            "name": "Soccer",

#Tournaments

text

GET https://api.sportradar.com/bet-coverage/v1/en/sports/{sport_id}/tournaments.json

Returns all tournaments (competitions) for a specified sport ID.

Parameters:

sport_id - Sport ID from the Sports endpoint (e.g., sr:sport:1)

View Request Example

text

https://api.sportradar.com/bet-coverage/v1/en/sports/sr:sport:1/tournaments.json?api_key={apiKey}

View Response Example

json

{
    "generated_at": "2025-07-07T09:24:53+00:00",
    "sport_tournaments": [
        {
            "id"

#Daily Schedule

text

GET https://api.sportradar.com/bet-coverage/v1/en/sports/{sport_id}/schedules/{date}/schedule.json

Returns daily fixtures grouped by tournaments for a specific date and sport.

Parameters:

sport_id - Sport ID from the Sports endpoint
date - Date in YYYY-MM-DD format

View Request Example

text

https://api.sportradar.com/bet-coverage/v1/en/sports/sr:sport:1/schedules/2025-04-12/schedule.json?api_key={apiKey}

View Response Example

json

#Tournament Schedule

text

GET https://api.sportradar.com/bet-coverage/v1/en/tournaments/{tournament_id}/schedule.json

Returns the complete schedule for a specific tournament.

Parameters:

tournament_id - Tournament ID from the Tournaments endpoint

View Request Example

text

https://api.sportradar.com/bet-coverage/v1/en/sports/sr:sport:40/stages.json?api_key={apiKey}

View Response Example

json

{
    "generated_at": "2025-07-07T10:29:47+00:00",
    "stages"

#Sport Stages

text

GET https://api.sportradar.com/bet-coverage/v1/en/sports/{sport_id}/stages.json

Returns all stages for a stage-based sport (sports with isStage: true).

Parameters:

sport_id - Stage sport ID from the Sports endpoint (e.g., sr:sport:40 for Formula 1)

warning

This endpoint only works for stage sports (Formula 1, MotoGP, Alpine Skiing, etc.). Use the Daily Schedule endpoint for classic sports.

View Request Example

text

https://api.sportradar.com/bet-coverage/v1/en/sports/sr:sport:40/stages.json?api_key={apiKey}

View Response Example

json

{
    "generated_at": "2025-07-07T10:29:47+00:00",
    "stages":

#Stage Daily Schedule

text

GET https://api.sportradar.com/bet-coverage/v1/en/sports/{sport_id}/schedules/{date}/stage_schedule.json

Returns daily stage events for a stage-based sport on a specific date.

Parameters:

sport_id - Stage sport ID from the Sports endpoint
date - Date in YYYY-MM-DD format

View Request Example

text

https://api.sportradar.com/bet-coverage/v1/en/sports/sr:sport:40/schedules/2025-03-14/stage_schedule.json?api_key={apiKey}

View Response Example

json

{
    "generated_at": "2025-07-07T10:51:21+00:00",
    "stages": [
        {
            "category": {
                "id": "sr:category:36",
                "

#References

#Coverage Values

Matches will have lmtCoverage or coverage.lmt value, which indicates LMT suitability of the match. These values bear the following meaning:

Code	Semantic Meaning
1	no Coverage
2	result and status only
3	basic Coverage
4	deep coverage

info

matches without coverage level information can be treated as matches with insufficient coverage to be used in LMT

Examples

json

"match": {
  "coverage": {
    "lmt": 4
  }
}

json

"match": {
  "lmtCoverage": 4
}

#Mapping API

The Mapping API provides match ID mappings between Sportradar's match IDs and your client's match IDs.

#How It Works

Client fixtures are ingested into Sportradar's mapping system via automated crawlers
System comparison matches client fixtures with Sportradar's fixture database
Mappings generated and made available through the API
Real-time updates as new matches are added or updated

note

This API replaces Sportradar's legacy SourceJoin service with improved performance and reliability.

#Endpoint

#Match ID Mappings

text

GET https://api.sportradar.com/bet-mapping/v1/en/match_mappings/{client_mapping_id}/entities.json

Returns Sportradar-to-client match ID mappings.

Parameters:

client_mapping_id - Your client mapping identifier
start (optional) - Offset for pagination (default: 0)

Pagination

This endpoint returns a maximum of 100 entities per request. Pagination information is provided in response headers:

X-Offset - Current offset
X-Result - Number of results in current response
X-Max-Results - Total available results

View Request Example

text

https://api.sportradar.com/bet-mapping/v1/en/match_mappings/{client_mapping_id}/entities.json?api_key={apiKey}&start=100

View Response Example

json

{
    "generated_at": "2025-07-07T11:19:02+00:00",
    "match_mappings": [
        {
            "sportradarId": "58244491",
            "externalId": "1024185935",
            "lastUpdated": "2025-07-07 01:41:00"
        },

{
    "generated_at": "2025-07-07T09:56:35+00:00",
    "sport_schedule_tournaments": [
        {
            "id": "sr:tournament:23",
            "name": "Serie A",
            "category": {
                "id": "sr:category:31",
                "name": "Italy",
                "countryCode": "ITA"
            },
            "season": {
                "id": "sr:season:130971",
                "name": "Serie A 25/26",
                "startDate": "2025-08-23",
                "endDate": "2026-05-25",
                "year": "25/26"
            },
            "matches": [
                {
                    "id": "sr:match:51273445",
                    "startTime": "2025-04-12 13:00:00",
                    "homeTeamId": "sr:competitor:2688",
                    "homeTeamName": "VENEZIA FC",
                    "betradarHomeTeamId": "sr:simple_team:32869",
                    "awayTeamId": "sr:competitor:2729",
                    "awayTeamName": "AC MONZA",
                    "betradarAwayTeamId": "sr:simple_team:16183030",
                    "simpleTournamentId": "sr:simple_tournament:33",
                    "coverage": {
                        "lmt": 4,
                        "insights": true
                    }
                },
                ...
            ]
        },
        {
            "id": "sr:tournament:35",
            "name": "Bundesliga",
            "category": {
                "id": "sr:category:30",
                "name": "Germany",
                "countryCode": "GER"
            },
            "season": {
                "id": "sr:season:130571",
                "name": "Bundesliga 25/26",
                "startDate": "2025-08-22",
                "endDate": "2026-05-26",
                "year": "25/26"
            },
            "matches": [
                {
                    "id": "sr:match:51269515",
                    "startTime": "2025-04-12 13:30:00",
                    "homeTeamId": "sr:competitor:2681",
                    "homeTeamName": "BAYER LEVERKUSEN",
                    "betradarHomeTeamId": "sr:simple_team:5089",
                    "awayTeamId": "sr:competitor:2547",
                    "awayTeamName": "UNION BERLIN",
                    "betradarAwayTeamId": "sr:simple_team:7114236",
                    "simpleTournamentId": "sr:simple_tournament:42",
                    "coverage": {
                        "lmt": 4,
                        "insights": true
                    }
                },
                ...
            ]
        },
        ...
    ]
}