> For the complete documentation index, see [llms.txt](https://quantaapi.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://quantaapi.gitbook.io/docs/cricket-api/series-list.md).

# Series List

Get a complete list of all cricket series, including past, ongoing, and upcoming tournaments with dates and status.

### 🧾 Overview – Fetch All Cricket Series

Use this API to retrieve a comprehensive list of all cricket series from our database. It includes major tournaments, tours, and leagues—helpful for filtering matches, categorizing content, or displaying upcoming events on your platform.

## 🚀 How to get Series List

To get Series List, make a POST request to the following endpoint:

<kbd><mark style="color:green;">POST<mark style="color:green;"></kbd><kbd><https://cricket.quantaapi.com/api/v1/series/list></kbd>

**Headers**

| Name          | Value              |
| ------------- | ------------------ |
| Content-Type  | `application/json` |
| Authorization | `Bearer <token>`   |

**Body**

| Name        | Type    | Description                                     |
| ----------- | ------- | ----------------------------------------------- |
| offset      | integer | Number of records to skip (used for pagination) |
| name        | string  | search by name                                  |
| start\_date | date    | search by start date \|\| after start date      |
| end\_date   | date    | search by end date \|\| befroe start date       |

**Response**

{% tabs %}
{% tab title="200" %}

```json
{
    "status": "success",
    "message": "Series list fetched successfully.",
    "code": 200,
    "type": "SUCCESS",
    "data": [
        {
            "id": "series_jJ6eFviZFihsUDh6ETocO0i0j",
            "name": "Bangladesh tour of UAE, 2025",
            "start_date": "2025-05-17",
            "end_date": "2025-05-19"
        },
        {
            "id": "series_FcISc2nYAeUMSwDV5qG6U6aSF",
            "name": "Bulgaria Women tour of Estonia, 2025",
            "start_date": "2025-05-15",
            "end_date": "2025-05-16"
        },
        {
            "id": "series_Du2eBaJSsj1GbXMciXkD7kBLF",
            "name": "Cook Islands tour of Japan, 2025",
            "start_date": "2025-05-13",
            "end_date": "2025-05-14"
        },
        {
            "id": "series_N4WLlqaz5ehijmpVTgjaUYcDM",
            "name": "Germany Women tour of Greece, 2025",
            "start_date": "2025-05-10",
            "end_date": "2025-05-11"
        },
        {
            "id": "series_gpI4oUBtk6OD16iwj7aTnWqhk",
            "name": "ICC Womens T20 World Cup Asia Qualifier 2025",
            "start_date": "2025-05-09",
            "end_date": "2025-05-20"
        },
        {
            "id": "series_lQAxJe95mcTb9AWNP4bpyTnxG",
            "name": "Japan T20I Tri-Series, 2025",
            "start_date": "2025-05-07",
            "end_date": "2025-05-11"
        },
        {
            "id": "series_vRz6SOgN7b2WwdIOKQzQ1Zfre",
            "name": "Estonia tour of Malta, 2025",
            "start_date": "2025-05-06",
            "end_date": "2025-05-07"
        },
        {
            "id": "series_soA0lXhBmvWr7UR9qvjRSLroK",
            "name": "Womens T20I Quadrangular Series in Thailand 2025",
            "start_date": "2025-05-03",
            "end_date": "2025-05-06"
        },
        {
            "id": "series_aXhpHIgLEhq2rkkWFEeyOd6TB",
            "name": "Bahrain Women tour of Oman, 2025",
            "start_date": "2025-05-02",
            "end_date": "2025-05-05"
        },
        {
            "id": "series_WaO5xNEMJzafehqcElA9o15ZO",
            "name": "New Zealand A tour to Bangladesh, 2025",
            "start_date": "2025-05-05",
            "end_date": "2025-05-24"
        },
        {
            "id": "series_fXxKlTEUooR2dnkGRUnhVT0pR",
            "name": "Croatia Women tour of Malta, 2025",
            "start_date": "2025-05-05",
            "end_date": "2025-05-05"
        },
        {
            "id": "series_UQF4bYMP1e7wzK426s5LHrBS6",
            "name": "Cyprus Women tour of Czech Republic, 2025",
            "start_date": "2025-05-02",
            "end_date": "2025-05-04"
        },
        {
            "id": "series_6PnAWTXUc0XoF34qM5X3O3Ddb",
            "name": "Womens T20I Quadrangular Series in Thailand 2025",
            "start_date": "2025-05-02",
            "end_date": "2025-05-06"
        },
        {
            "id": "series_TnTAWGwyvyyc4HUwmRJaIqKVH",
            "name": "Sri Lanka Womens Tri-Nation Series, 2025",
            "start_date": "2025-04-27",
            "end_date": "2025-05-11"
        },
        {
            "id": "series_lUWYeHfdgp5dboebgOjxamYlW",
            "name": "Kalahari Womens T20I Tournament, 2025",
            "start_date": "2025-04-26",
            "end_date": "2025-04-30"
        },
        {
            "id": "series_nW30Zd8fulEZX4ZCjXRSZxV2z",
            "name": "Zimbabwe Women tour of USA, 2025",
            "start_date": "2025-04-25",
            "end_date": "2025-05-03"
        },
        {
            "id": "series_qz71ZKgqHLyz5X5xn76s2LIth",
            "name": "Malaysia Quadrangular T20I Series, 2025",
            "start_date": "2025-04-24",
            "end_date": "2025-05-02"
        },
        {
            "id": "series_gZH63U7bjs2xQ1xgWqJdd8tdX",
            "name": "Zimbabwe tour of Bangladesh, 2025",
            "start_date": "2025-04-20",
            "end_date": "2025-05-02"
        },
        {
            "id": "series_Kqre6qIvNdIToZsp3ZbspyVyq",
            "name": "The North American T20 Cup, 2025",
            "start_date": "2025-04-19",
            "end_date": "2025-04-23"
        },
        {
            "id": "series_hOKzRTWHO07h1KefiO1qYUe9J",
            "name": "Womens T20I Quadrangular Series 2025",
            "start_date": "2025-04-18",
            "end_date": "2025-04-20"
        },
        {
            "id": "series_TrwJ5QWsU9p7IuG8xGDGhEMoe",
            "name": "Central American Cricket Championships, 2025",
            "start_date": "2025-04-17",
            "end_date": "2025-04-20"
        },
        {
            "id": "series_U79sjzmQIk7r61swfc9HanQB4",
            "name": "Tri-Nation Series in UAE, 2025",
            "start_date": "2025-04-13",
            "end_date": "2025-04-25"
        },
        {
            "id": "series_qFdEi41pbJyKUatdDHahmOJUe",
            "name": "Pakistan Super League, 2025",
            "start_date": "2025-04-11",
            "end_date": "9999-12-31"
        },
        {
            "id": "series_6bAY2pR4w9NZ2l0mNydsm8NXs",
            "name": "Hong Kong T20I Quadrangular Series, 2025",
            "start_date": "2025-04-09",
            "end_date": "2025-04-13"
        },
        {
            "id": "series_D15QXoOAWL1fieS3acJx92xwX",
            "name": "ICC Womens World Cup Qualifier, 2025",
            "start_date": "2025-04-09",
            "end_date": "2025-04-19"
        }
    ],
    "info": {
        "total": 115,
        "limit": 25,
        "offset": 0,
        "remaining": 90,
        "timestamp_utc": "2025-05-17 13:47:50",
        "version": "v1.0",
        "credits_used": 1,
        "response_time": 120.64
    }
}
```

{% endtab %}

{% tab title="401" %}

```json
{
    "status": "error",
    "message": "The provided authorization token is invalid or expired",
    "code": 401,
    "type": "AUTHORIZATION_INVALID"
}
```

{% endtab %}

{% tab title="422" %}

```json
{
    "status": "error",
    "message": "Validation Error",
    "code": 422,
    "type": "VALIDATION_ERROR",
    "errors": {
        "start_date": [
            "Start date must be a valid date."
        ]
    }
}
```

{% endtab %}
{% endtabs %}
