BET Utility API

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

#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

#Sport Hierarchy Types

Sportradar uses two different sport hierarchy structures:

#Endpoints

#Sports

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.

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

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

#Tournaments

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)

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

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

#Daily Schedule

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

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

#Tournament Schedule

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

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

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

#Sport Stages

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)

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

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

#Stage Daily Schedule

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

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

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

#Mapping API

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

#How It Works

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

#Endpoint

#Match ID Mappings

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)

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

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

These sports have isStage: false in the API response.

{
    "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
                    }
                },
                ...
            ]
        },
        ...
    ]
}