> 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-match-list.md).

# Series Match List

Get a complete list of all matches scheduled or played in a specific cricket series using the series ID.

### 🧾 Fetch All Matches in a Cricket Series

This API provides the full list of matches for a given cricket series. It includes detailed information like match ID, teams, date, venue, match type, and status. It is useful for building series-wise match schedules, fixtures, and results.

## 🚀 How to get Series Match List

To get Series Match 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/{id}/matches></kbd>

**Headers**

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

**Body**

| Name | Type   | Description    |
| ---- | ------ | -------------- |
| name | string | search by name |
| date | date   | search by date |

**Response**

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

```json
{
    "status": "success",
    "message": "Series matches fetched successfully.",
    "code": 200,
    "type": "SUCCESS",
    "data": [
        {
            "id": "match_F7fpcj2blvRYs14rA5cEsI09T",
            "name": "Chennai Super Kings vs Mumbai Indians, 3rd Match",
            "match_type": "t20",
            "datetime_utc": "2025-03-23 14:00:00",
            "venue": "MA Chidambaram Stadium, Chennai"
        },
        {
            "id": "match_J7QbT4JSZGMAolIhXm34bwyE0",
            "name": "Gujarat Titans vs Mumbai Indians, 9th Match",
            "match_type": "t20",
            "datetime_utc": "2025-03-29 14:00:00",
            "venue": "Narendra Modi Stadium, Ahmedabad"
        },
        {
            "id": "match_yDLbPbp27GTyAGyaG0uGeD1dH",
            "name": "Mumbai Indians vs Kolkata Knight Riders, 12th Match",
            "match_type": "t20",
            "datetime_utc": "2025-03-31 14:00:00",
            "venue": "Wankhede Stadium, Mumbai"
        },
        {
            "id": "match_crVjMoamsAxX4npnMj5RDeALv",
            "name": "Lucknow Super Giants vs Mumbai Indians, 16th Match",
            "match_type": "t20",
            "datetime_utc": "2025-04-04 14:00:00",
            "venue": "Bharat Ratna Shri Atal Bihari Vajpayee Ekana Cricket Stadium, Lucknow"
        },
        {
            "id": "match_Wt6Xt7Zr1O8pdw5372UgQSIF6",
            "name": "Mumbai Indians vs Royal Challengers Bengaluru, 20th Match",
            "match_type": "t20",
            "datetime_utc": "2025-04-07 14:00:00",
            "venue": "Wankhede Stadium, Mumbai"
        },
        {
            "id": "match_sLbmK5VWeaV9QMSRHo2CGn3mR",
            "name": "Delhi Capitals vs Mumbai Indians, 29th Match",
            "match_type": "t20",
            "datetime_utc": "2025-04-13 14:00:00",
            "venue": "Arun Jaitley Stadium, Delhi"
        },
        {
            "id": "match_GsAD2MbPrsmmr9sXmj3qj6TZN",
            "name": "Mumbai Indians vs Sunrisers Hyderabad, 33rd Match",
            "match_type": "t20",
            "datetime_utc": "2025-04-17 14:00:00",
            "venue": "Wankhede Stadium, Mumbai"
        },
        {
            "id": "match_ByN7agfk6DRxSLIEsZqAV6hkq",
            "name": "Mumbai Indians vs Chennai Super Kings, 38th Match",
            "match_type": "t20",
            "datetime_utc": "2025-04-20 14:00:00",
            "venue": "Wankhede Stadium, Mumbai"
        },
        {
            "id": "match_2pgxrd9EOjYNgN6uIjE3Zdplp",
            "name": "Sunrisers Hyderabad vs Mumbai Indians, 41st Match",
            "match_type": "t20",
            "datetime_utc": "2025-04-23 14:00:00",
            "venue": "Rajiv Gandhi International Stadium, Hyderabad"
        },
        {
            "id": "match_bog4qGc9q9Kse5RddziH82jch",
            "name": "Mumbai Indians vs Lucknow Super Giants, 45th Match",
            "match_type": "t20",
            "datetime_utc": "2025-04-27 10:00:00",
            "venue": "Wankhede Stadium, Mumbai"
        },
        {
            "id": "match_Beq3ge2A3u91B0lGfcmNQcGuq",
            "name": "Rajasthan Royals vs Mumbai Indians, 50th Match",
            "match_type": "t20",
            "datetime_utc": "2025-05-01 14:00:00",
            "venue": "Sawai Mansingh Stadium, Jaipur"
        },
        {
            "id": "match_sBDpKwvvdOvCdafMP9T5TVkF4",
            "name": "Mumbai Indians vs Gujarat Titans, 56th Match",
            "match_type": "t20",
            "datetime_utc": "2025-05-06 14:00:00",
            "venue": "Wankhede Stadium, Mumbai"
        },
        {
            "id": "match_nnyCdmtQAIGtSho95uxQ1dq5u",
            "name": "Mumbai Indians vs Delhi Capitals, 63rd Match",
            "match_type": "t20",
            "datetime_utc": "2025-05-21 14:00:00",
            "venue": "Wankhede Stadium, Mumbai"
        },
        {
            "id": "match_0gFqGCMAprF57dpkiLuv7SCmI",
            "name": "Punjab Kings vs Mumbai Indians, 69th Match",
            "match_type": "t20",
            "datetime_utc": "2025-05-26 14:00:00",
            "venue": "Sawai Mansingh Stadium, Jaipur"
        }
    ],
    "info": {
        "series_id": "series_82eRHl5CZEFaubm2dk2zt492b",
        "total": 14,
        "limit": 25,
        "offset": 0,
        "remaining": 0,
        "timestamp_utc": "2025-05-17 13:53:48",
        "version": "v1.0",
        "credits_used": 2,
        "response_time": 106.79
    }
}
```

{% 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": {
        "date": [
            "Date must be a valid date."
        ]
    }
}
```

{% endtab %}
{% endtabs %}