> 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/match-list.md).
# Match List
Fetch the complete list of cricket matches across all series, with optional filtering support.
### ๐งพ Retrieve the Full List of Cricket Matches
This API provides a complete list of cricket matches from all available series. You can use this to show upcoming, live, or completed matches in your app, with support for filters like series ID, date, and match status.
## ๐ How to get Match List
To get Match List, make a POST request to the following endpoint:
POST
**Headers**
| Name | Value |
| ------------- | ------------------ |
| Content-Type | `application/json` |
| Authorization | `Bearer ` |
**Body**
| Name | Type | Description |
| ---- | ------ | -------------- |
| name | string | search by name |
| date | date | search by date |
**Response**
{% tabs %}
{% tab title="200" %}
```json
{
"status": "success",
"message": "Matches fetched successfully.",
"code": 200,
"type": "SUCCESS",
"data": [
{
"id": "match_HlWP96MILLrN4W6IJmfIYrvUy",
"name": "England vs India, 5th Test",
"match_type": "test",
"datetime_utc": "2025-07-31 10:00:00",
"venue": "Kennington Oval, London",
"series_id": "series_vThfhch431R2HrojwBbB4hFzI",
"series_name": "India tour of England, 2025"
},
{
"id": "match_HebaT4lfLSocCksdOYnPxD7gh",
"name": "England vs India, 4th Test",
"match_type": "test",
"datetime_utc": "2025-07-23 10:00:00",
"venue": "Emirates Old Trafford, Manchester",
"series_id": "series_vThfhch431R2HrojwBbB4hFzI",
"series_name": "India tour of England, 2025"
},
{
"id": "match_5EZQV22lz3fhR8k6y4gzHDw5b",
"name": "England vs India, 3rd Test",
"match_type": "test",
"datetime_utc": "2025-07-10 10:00:00",
"venue": "Lord's, London",
"series_id": "series_vThfhch431R2HrojwBbB4hFzI",
"series_name": "India tour of England, 2025"
},
{
"id": "match_zGWj3DadZeocRE7ty7koXrX4I",
"name": "England vs India, 2nd Test",
"match_type": "test",
"datetime_utc": "2025-07-02 10:00:00",
"venue": "Edgbaston, Birmingham",
"series_id": "series_vThfhch431R2HrojwBbB4hFzI",
"series_name": "India tour of England, 2025"
},
{
"id": "match_S6KEdUD2PVonmVnnZJXAYiGSg",
"name": "England vs India, 1st Test",
"match_type": "test",
"datetime_utc": "2025-06-20 10:00:00",
"venue": "Headingley, Leeds",
"series_id": "series_vThfhch431R2HrojwBbB4hFzI",
"series_name": "India tour of England, 2025"
},
{
"id": "match_AtaPDYwZc2uyWBcdE4d276ClN",
"name": "England vs West Indies, 3rd T20I",
"match_type": "t20",
"datetime_utc": "2025-06-10 17:30:00",
"venue": "The Rose Bowl, Southampton",
"series_id": "series_7GxDCcwzTHmldYZgXpjETQ8V4",
"series_name": "West Indies tour of England, 2025"
},
{
"id": "match_qiJqp5KsbiCgErIbXARXS1Gwi",
"name": "England vs West Indies, 3rd T20I",
"match_type": "t20",
"datetime_utc": "2025-06-08 13:30:00",
"venue": "The Rose Bowl, Southampton",
"series_id": "series_7GxDCcwzTHmldYZgXpjETQ8V4",
"series_name": "West Indies tour of England, 2025"
},
{
"id": "match_qR5w0NmUEcCOGT2gDJrWNpsGl",
"name": "England Women vs West Indies Women, 3rd ODI",
"match_type": "odi",
"datetime_utc": "2025-06-07 10:00:00",
"venue": "The Cooper Associates County Ground, Taunton",
"series_id": "series_MsxBocZ8aPc8j5JuG5NiPlKTm",
"series_name": "West Indies Women tour of England, 2025"
},
{
"id": "match_qtWjMSsdqlX8tBYXvQEJCmiF4",
"name": "England vs West Indies, 1st T20I",
"match_type": "t20",
"datetime_utc": "2025-06-06 17:30:00",
"venue": "Riverside Ground, Chester-le-Street",
"series_id": "series_7GxDCcwzTHmldYZgXpjETQ8V4",
"series_name": "West Indies tour of England, 2025"
},
{
"id": "match_39toFREUyxBwLxD7KBIIO8vhj",
"name": "England Women vs West Indies Women, 2nd ODI",
"match_type": "odi",
"datetime_utc": "2025-06-04 12:00:00",
"venue": "Grace Road, Leicester",
"series_id": "series_MsxBocZ8aPc8j5JuG5NiPlKTm",
"series_name": "West Indies Women tour of England, 2025"
},
{
"id": "match_kWB9Q4TtmLeGqUNlH4Jw4c7vY",
"name": "England vs West Indies, 3rd ODI",
"match_type": "odi",
"datetime_utc": "2025-06-03 12:00:00",
"venue": "Kennington Oval, London",
"series_id": "series_7GxDCcwzTHmldYZgXpjETQ8V4",
"series_name": "West Indies tour of England, 2025"
},
{
"id": "match_0vTf8Epae34ZskWMEi8fKFlOT",
"name": "England vs West Indies, 2nd ODI",
"match_type": "odi",
"datetime_utc": "2025-06-01 10:00:00",
"venue": "Sophia Gardens, Cardiff",
"series_id": "series_7GxDCcwzTHmldYZgXpjETQ8V4",
"series_name": "West Indies tour of England, 2025"
},
{
"id": "match_FMW3NLvSjxvsLwz4UZMZoogfv",
"name": "England Women vs West Indies Women, 1st ODI",
"match_type": "odi",
"datetime_utc": "2025-05-30 12:00:00",
"venue": "County Ground, Derby",
"series_id": "series_MsxBocZ8aPc8j5JuG5NiPlKTm",
"series_name": "West Indies Women tour of England, 2025"
},
{
"id": "match_NEzkqsLal7uV8gwGNv6SldBsH",
"name": "England vs West Indies, 1st ODI",
"match_type": "odi",
"datetime_utc": "2025-05-29 12:00:00",
"venue": "Edgbaston, Birmingham",
"series_id": "series_7GxDCcwzTHmldYZgXpjETQ8V4",
"series_name": "West Indies tour of England, 2025"
},
{
"id": "match_OavnBSLqFqTxIkCkFCa6TAbG8",
"name": "United Arab Emirates vs Bangladesh, 2nd T20I",
"match_type": "t20",
"datetime_utc": "2025-05-19 15:00:00",
"venue": "Sharjah Cricket Stadium, Sharjah",
"series_id": "series_jJ6eFviZFihsUDh6ETocO0i0j",
"series_name": "Bangladesh tour of UAE, 2025"
},
{
"id": "match_rb8gn0qcFvaX1r4nvRgp4R7kL",
"name": "United Arab Emirates vs Bangladesh, 1st T20I",
"match_type": "t20",
"datetime_utc": "2025-05-17 15:00:00",
"venue": "Sharjah Cricket Stadium, Sharjah",
"series_id": "series_jJ6eFviZFihsUDh6ETocO0i0j",
"series_name": "Bangladesh tour of UAE, 2025"
},
{
"id": "match_MUvenvlgZ0ndZnUghGebS8EaE",
"name": "name",
"match_type": "test",
"datetime_utc": "2025-05-22 10:00:00",
"venue": null,
"series_id": "series_ZwG5htQX0QPBkqSy9fr2b7URC",
"series_name": "Zimbabwe tour of England, 2025"
},
{
"id": "match_FKVtxfnwaeoBxUTCPsx0fIEX2",
"name": "name",
"match_type": "odi",
"datetime_utc": "2025-05-21 17:00:00",
"venue": null,
"series_id": "series_YnTWHHMWUfXgdpf2tSqqhelAL",
"series_name": "ICC Cricket World Cup League Two 2023-27"
},
{
"id": "match_4mRFC8prh7FfaGd7HVGX7Dr5z",
"name": "name",
"match_type": "t20",
"datetime_utc": "2025-05-21 17:30:00",
"venue": null,
"series_id": "series_MsxBocZ8aPc8j5JuG5NiPlKTm",
"series_name": "West Indies Women tour of England, 2025"
},
{
"id": "match_8PNtX5pRwBQ5jYs5saVdhb4q5",
"name": "Oman vs Canada, 69th Match",
"match_type": "odi",
"datetime_utc": "2025-05-19 17:00:00",
"venue": "Central Broward Regional Park Stadium Turf Ground, Lauderhill, Florida",
"series_id": "series_YnTWHHMWUfXgdpf2tSqqhelAL",
"series_name": "ICC Cricket World Cup League Two 2023-27"
},
{
"id": "match_9GWBdDs1qAdGjxnrRDvxGtiQD",
"name": "United States of America vs Canada, 68th Match",
"match_type": "odi",
"datetime_utc": "2025-05-17 17:00:00",
"venue": "Central Broward Regional Park Stadium Turf Ground, Lauderhill, Florida",
"series_id": "series_YnTWHHMWUfXgdpf2tSqqhelAL",
"series_name": "ICC Cricket World Cup League Two 2023-27"
},
{
"id": "match_Im6dUY9RYyGhRTGT2WR5rhKWN",
"name": "name",
"match_type": "odi",
"datetime_utc": "2025-05-14 09:00:00",
"venue": null,
"series_id": "series_YnTWHHMWUfXgdpf2tSqqhelAL",
"series_name": "ICC Cricket World Cup League Two 2023-27"
},
{
"id": "match_o5RSdKpk1Zlrp8Yz3BReSetws",
"name": "name",
"match_type": "odi",
"datetime_utc": "2025-05-12 09:00:00",
"venue": null,
"series_id": "series_YnTWHHMWUfXgdpf2tSqqhelAL",
"series_name": "ICC Cricket World Cup League Two 2023-27"
},
{
"id": "match_S0EuQGcKcYL6oFKyVM1xEcsoC",
"name": "name",
"match_type": "t20",
"datetime_utc": "2025-05-10 00:30:00",
"venue": null,
"series_id": "series_lQAxJe95mcTb9AWNP4bpyTnxG",
"series_name": "Japan T20I Tri-Series, 2025"
},
{
"id": "match_azx8TESw4GSdCXVcYVk2NZnyc",
"name": "name",
"match_type": "t20",
"datetime_utc": "2025-05-10 05:30:00",
"venue": null,
"series_id": "series_lQAxJe95mcTb9AWNP4bpyTnxG",
"series_name": "Japan T20I Tri-Series, 2025"
}
],
"info": {
"total": 1193,
"limit": 25,
"offset": 0,
"remaining": 1168,
"timestamp_utc": "2025-05-17 13:56:51",
"version": "v1.0",
"credits_used": 2,
"response_time": 359.45
}
}
```
{% 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 %}