Fixtures

This API is designed to deliver fixtures based on filters. Retrieve upcoming, ongoing, or completed fixtures for various cricket events.

Fixtures can be retrieved by providing either one of the filters. This API supports two filters.

1. Date range filters. You can specify the date range using the start_date and end_date query param OR

2. Filter fixtures by either season_id, league_id or series_id

Examples

Date Range (Fetch all fixtures between the specified date range)

The below API fetches all fixtures between 2024-01-01 and 2024-01-01

https://cricket.sportsjupiter.com/v1/fixtures?api_token={api_token}&start_date=2024-01-01&end_date=2024-01-31

OR

Fetch all fixtures for a single season (IPL 2024 season)

https://cricket.sportsjupiter.com/v1/fixtures?api_token={api_token}&season_id=1484

Fetch all fixtures for multiple seasons (IPL 2024 season and 2023/2024 ODI women)

https://cricket.sportsjupiter.com/v1/fixtures?api_token={api_token}&season_id=1484,1490

Similarly, you can pass as many season IDs to fetch fixtures for multiple seasons. You can find all available season IDs from the seasons API.

Fetch all fixtures for a single league (T20 International)

https://cricket.sportsjupiter.com/v1/fixtures?api_token={api_token}&league_id=3

Fetch all fixtures for multiple leagues (T20 International and ODI International)

https://cricket.sportsjupiter.com/v1/fixtures?api_token={api_token}&league_id=3,2

Similarly, you can pass as many league IDs to fetch fixtures for multiple leagues. You can find all available league IDs from the leaguesAPI.

Fetch all fixtures for a series

This filter is tailor-made to work along with the featured series endpoint. You can send featured series IDs into this API to fetch all fixtures for a specific series.

Featured series API Request

https://cricket.sportsjupiter.com/v1/featured-series?api_token={api_token}

API Reponse

{
    "data": [
        {
            "name": "West Indies tour of Australia",
            "code": "WIA",
            "series_id": "4541,4538,4535"
        },
        {
            "name": "Afghanistan tour of Sri Lanka",
            "code": "ASL",
            "series_id": "5306,5309,5312"
        },
        {
            "name": "South Africa tour of New Zealand",
            "code": "SANZ",
            "series_id": "5255"
        },
        {
            "name": "Afghanistan tour of India",
            "code": "AI",
            "series_id": "5051"
        },
        {
            "name": "Big Bash League",
            "code": "BBL",
            "series_id": "4748,4751"
        },
        {
            "name": "Canada Tour Of Nepal",
            "code": "CANNEP",
            "series_id": "5375"
        },
        {
            "name": "CSA T20 Challenge",
            "code": "T20C",
            "series_id": "5243,5246"
        }
    ]
}

In the above API response, the West Indies Tour of Australia contains three series IDs (Test, T20 and ODI). You can simply pass these series IDs in the series_idquery param to fetch all fixtures for a specific series like the below:

https://cricket.sportsjupiter.com/v1/fixtures?api_token={api_token}&series_id=4541,4538,4535