> 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-details.md).

# Match Details

Retrieve detailed information about a specific cricket match using its unique match ID.

### 🧾 Get Detailed Information for a Cricket Match

This API provides comprehensive details about a single cricket match, including teams, venue, match timing, status, scores (if available), and other relevant match data. Perfect for detailed match pages or live scoreboards.

## 🚀 How to get Match Details

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

**Headers**

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

**Response**

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

```json
{
    "status": "success",
    "message": "Match detail fetched successfully.",
    "code": 200,
    "type": "SUCCESS",
    "data": {
        "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",
        "teams": [
            {
                "id": "team_ndpwtC34Z2eMiYMUUqp1YR8Xr",
                "team_name": "Mumbai Indians",
                "short_name": "MI"
            },
            {
                "id": "team_vDTybeY5sdAaMiS5zkOSCdINq",
                "team_name": "Punjab Kings",
                "short_name": "PBKS"
            }
        ],
        "toss_winner": "--",
        "toss_choice": "--",
        "match_started": false,
        "match_ended": false,
        "has_squad": false,
        "status": "upcoming",
        "result": "Match not started",
        "series_id": "series_82eRHl5CZEFaubm2dk2zt492b",
        "series_name": "Indian Premier League 2025",
        "last_update": "2025-05-17"
    },
    "info": {
        "id": "match_0gFqGCMAprF57dpkiLuv7SCmI",
        "timestamp_utc": "2025-05-17 13:57:45",
        "version": "v1.0",
        "credits_used": 3,
        "response_time": 104.07
    }
}
```

{% endtab %}

{% tab title="401" %}

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

{% endtab %}
{% endtabs %}