Cricket API – Match Numbering

We've added support for match numbering on relevant leagues and multi-team tournaments in our Cricket API.

The competition_sport_event_number attribute (under tournament_round) is an integer representing the match number within a competition. It applies to competitions that assign fixed match numbers, such as the IPL or World Cup.

This attribute is already established in our Soccer API. If you integrate with Soccer, competition_sport_event_number behaves the same way in Cricket.

⭐ Benefit

Use match numbers to order and label matches within a tournament, so your schedules and match displays align with the official numbering fans recognize (for example, "Match 40" of the IPL).

📋 Recommended Actions

Read the competition_sport_event_number attribute under tournament_round to display match numbers in tournament schedules and match details.
Treat the attribute as optional — it is only present for competitions that assign fixed match numbers (such as the IPL or World Cup), not for every tournament or series.
If you already use this attribute in our Soccer API, apply the same handling in Cricket, since it behaves identically.

☑️ Sample Requests:

Match Summary Endpoint

curl --request GET \
     --url https://api.sportradar.com/cricket-t2/en/matches/{match_id}/summary.json \
     --header 'accept: application/json' \
     --header 'x-api-key: YOUR_API_KEY'

Tournament Schedule Endpoint

curl --request GET \
     --url https://api.sportradar.com/cricket-t2/en/tournaments/sr:tournament:2472/schedule.json \
     --header 'accept: application/json' \
     --header 'x-api-key: YOUR_API_KEY'

🔢 Products

Sport	Product	Version(s)
Cricket	Cricket API	v2

🔁 Endpoints Affected

Daily feeds: Daily Live Schedule, Daily Results, Daily Schedule

Match feeds: Match Lineups, Match Summary, Match Timeline, Match Timeline Delta

Team feeds: Team Results, Team Schedule, Team vs Team

Tournament feeds: Tournament Results, Tournament Schedule

⚙️ Return Samples

{
    "sport_event": {
        "id": "sr:match:70777504",
        "tournament_round": {
            "type": "group",
            "number": 1,
            "competition_sport_event_number": 3
        },
        "season": {
            "id": "sr:season:141170",
            "name": "ODI Series Ireland vs West Indies, Women 2026",
            "start_date": "2026-07-10",
            "end_date": "2026-07-15",
            "year": "2026"
        },
        "scheduled": "2026-07-15T09:45:00+00:00",
        "start_time_tbd": false,
        "status": "closed",
        "competitors": [
            {
                "id": "sr:competitor:247867",
                "name": "Ireland",
                "country": "Ireland",
                "country_code": "IRL",
                "abbreviation": "IRL",
                "qualifier": "home",
                "gender": "female"
            },
            {
                "id": "sr:competitor:183549",
                "name": "West Indies",
                "abbreviation": "WIN",
                "qualifier": "away",
                "gender": "female"
            }
        ],
        "venue": {
            "id": "sr:venue:21748",
            "name": "Bready Cricket Club",
            "city_name": "Magheramason",
            "city_id": "sr:city:11728",
            "country_name": "Northern Ireland",
            "country_code": "NIR",
            "timezone": "Europe/London"
        }
    },
    ...

<sport_events>
    <sport_event id="sr:match:69832128" scheduled="2026-03-28T14:00:00+00:00" start_time_tbd="false" status="closed">
        <tournament_round type="group" number="1" competition_sport_event_number="1"/>
        <season id="sr:season:131399" name="Indian Premier League 2026" start_date="2026-03-28" end_date="2026-05-31" year="2026"/>
        <tournament id="sr:tournament:2472" name="Indian Premier League" type="t20" gender="men">
            <sport id="sr:sport:21" name="Cricket"/>
            <category id="sr:category:497" name="India" country_code="IND"/>
        </tournament>
        <competitors>
            <team id="sr:competitor:152318" name="Royal Challengers Bengaluru" country="India" country_code="IND" abbreviation="RCB" qualifier="home" gender="male"/>
            <team id="sr:competitor:152316" name="Sunrisers Hyderabad" country="India" country_code="IND" abbreviation="SRH" qualifier="away" gender="male"/>
        </competitors>
        <venue id="sr:venue:19691" name="M.Chinnaswamy Stadium" capacity="40000" city_name="Bangalore" city_id="sr:city:2728" country_name="India" map_coordinates="12.978806, 77.599556" country_code="IND" timezone="Asia/Kolkata">
            <bowling_ends>
                <bowling_end name="Pavilion End"/>
                <bowling_end name="BEML End"/>
            </bowling_ends>
        </venue>
    </sport_event>
    <sport_event id="sr:match:69832130" scheduled="2026-03-29T14:00:00+00:00" start_time_tbd="false" status="closed">
        <tournament_round type="group" number="1" competition_sport_event_number="2"/>
        <season id="sr:season:131399" name="Indian Premier League 2026" start_date="2026-03-28" end_date="2026-05-31" year="2026"/>
        <tournament id="sr:tournament:2472" name="Indian Premier League" type="t20" gender="men">
            <sport id="sr:sport:21" name="Cricket"/>
            <category id="sr:category:497" name="India" country_code="IND"/>
        </tournament>
        <competitors>
            <team id="sr:competitor:152324" name="Mumbai Indians" country="India" country_code="IND" abbreviation="MI" qualifier="home" gender="male"/>
            <team id="sr:competitor:152326" name="Kolkata Knight Riders" country="India" country_code="IND" abbreviation="KKR" qualifier="away" gender="male"/>
        </competitors>
        <venue id="sr:venue:19683" name="Wankhede Stadium" capacity="45000" city_name="Mumbai" city_id="sr:city:2726" country_name="India" map_coordinates="18.938917, 72.825722" country_code="IND" timezone="Asia/Kolkata">
            <bowling_ends>
                <bowling_end name="Garware Pavilion End"/>
                <bowling_end name="Tata End"/>
            </bowling_ends>
        </venue>
    </sport_event>
    ...

<sport_event id="sr:match:71737408" scheduled="2026-05-26T03:00:00+00:00" start_time_tbd="false">
<tournament_round type="group" number="1" competition_sport_event_number="40"/>
<season id="sr:season:141564" name="Dhaka Premier Division Cricket League 2026" start_date="2026-05-04" end_date="2026-08-30" year="2026"/>
<tournament id="sr:tournament:32127" name="Dhaka Premier Division Cricket League" type="list_a" gender="men">
    <sport id="sr:sport:21" name="Cricket"/>
    <category id="sr:category:834" name="Bangladesh" country_code="BGD"/>
</tournament>
<competitors>
    <team id="sr:competitor:688321" name="Prime Bank Cricket Club" country="Bangladesh" country_code="BAN" abbreviation="PRI" qualifier="home" gender="male"/>
    <team id="sr:competitor:998697" name="City Club" country="Bangladesh" country_code="BAN" abbreviation="CIT" qualifier="away" gender="male"/>
</competitors>
<sport_event_conditions type="list_a" day_night="day"/>
</sport_event>