> For the complete documentation index, see [llms.txt](https://cricketdocs.sportsjupiter.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cricketdocs.sportsjupiter.com/fixtures.md).

# 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](https://cricket.sportsjupiter.com/v1/fixtures?api_token=d28295a9-3e65-4aef-89c5-9c39fe2b15ea\&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=14](https://cricket.sportsjupiter.com/v1/fixtures?api_token=d28295a9-3e65-4aef-89c5-9c39fe2b15ea\&season_id=1490)[84](https://cricket.sportsjupiter.com/v1/fixtures?api_token=d28295a9-3e65-4aef-89c5-9c39fe2b15ea\&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](https://cricket.sportsjupiter.com/v1/fixtures?api_token=d28295a9-3e65-4aef-89c5-9c39fe2b15ea\&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](https://cricket.sportsjupiter.com/v1/fixtures?api_token=d28295a9-3e65-4aef-89c5-9c39fe2b15ea\&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](https://cricket.sportsjupiter.com/v1/fixtures?api_token=d28295a9-3e65-4aef-89c5-9c39fe2b15ea\&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 `leagues`API.

**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}](https://cricket.sportsjupiter.com/v1/featured-series?api_token=d28295a9-3e65-4aef-89c5-9c39fe2b15ea)

<details>

<summary>API Reponse</summary>

```json
{
    "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"
        }
    ]
}
```

</details>

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_id`query 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](https://cricket.sportsjupiter.com/v1/fixtures?api_token=d28295a9-3e65-4aef-89c5-9c39fe2b15ea\&series_id=4541,4538,4535)