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

# Team Details

Retrieve comprehensive information about a cricket team using its unique team ID.

### 🧾 Get Detailed Information for a Cricket Team

This API provides detailed information about a cricket team including team name, country, squad members and other relevant details. Useful for team profiles, player listings, and fan engagement features.

## 🚀 How to get Team Details

To get Team 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/teams/{id}/details></kbd>

**Headers**

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

**Response**

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

```json
{
    "status": "success",
    "message": "Team detail fetched successfully.",
    "code": 200,
    "type": "SUCCESS",
    "data": {
        "id": "team_ndpwtC34Z2eMiYMUUqp1YR8Xr",
        "team_name": "Mumbai Indians",
        "short_name": "MI",
        "series_id": "series_82eRHl5CZEFaubm2dk2zt492b",
        "series_name": "Indian Premier League 2025",
        "info": {
            "matches": 12,
            "wins": 7,
            "loss": 5,
            "ties": 0,
            "no_result": 0,
            "points": 14
        },
        "players": [
            {
                "id": "03bda674-3916-4d64-952e-00a6c19c01e1",
                "name": "Rohit Sharma",
                "role": "Batsman",
                "batting_style": "Right Handed Bat",
                "bowling_style": "Right-arm offbreak"
            },
            {
                "id": "aefd9074-da5a-408d-94f1-3be0e79d3b82",
                "name": "Tilak Varma",
                "role": "Batsman",
                "batting_style": "Left Handed Bat",
                "bowling_style": "Right-arm offbreak"
            },
            {
                "id": "71add5ac-55f9-4eb7-9e0c-d51208ae20c0",
                "name": "Naman Dhir",
                "role": "Batsman",
                "batting_style": "Right Handed Bat",
                "bowling_style": "Right-arm offbreak"
            },
            {
                "id": "8c579447-bfbd-4cf6-a283-db4dc1d5ac33",
                "name": "Suryakumar Yadav",
                "role": "Batsman",
                "batting_style": "Right Handed Bat",
                "bowling_style": "Right-arm offbreak"
            },
            {
                "id": "c510fbe6-8a16-47e4-ab60-0965720241af",
                "name": "Will Jacks",
                "role": "Batting Allrounder",
                "batting_style": "Right Handed Bat",
                "bowling_style": "Right-arm offbreak"
            },
            {
                "id": "a90b2371-5c53-4c29-a382-9b52d40a7548",
                "name": "Hardik Pandya",
                "role": "Batting Allrounder",
                "batting_style": "Right Handed Bat",
                "bowling_style": "Right-arm fast-medium"
            },
            {
                "id": "b64ccf20-292a-4834-b3d7-9de55187f44a",
                "name": "Raj Bawa",
                "role": "Batting Allrounder",
                "batting_style": "Left Handed Bat",
                "bowling_style": "Right-arm fast-medium"
            },
            {
                "id": "0485d865-4d05-4d4f-a5ba-f64c9380ee7d",
                "name": "Bevon Jacobs",
                "role": "Batting Allrounder",
                "batting_style": "Right Handed Bat",
                "bowling_style": "Right-arm fast-medium"
            },
            {
                "id": "6004fd3f-2264-470d-b39f-340d530b19b3",
                "name": "Trent Boult",
                "role": "Bowler",
                "batting_style": "Right Handed Bat",
                "bowling_style": "Left-arm fast-medium"
            },
            {
                "id": "cb665f43-1f13-4ae8-acd9-8695ea5fbf9f",
                "name": "Karn Sharma",
                "role": "Bowler",
                "batting_style": "Left Handed Bat",
                "bowling_style": "Right-arm legbreak"
            },
            {
                "id": "915fed39-1b6a-4bb0-b7ef-88ee2f4152fd",
                "name": "Lizaad Williams",
                "role": "Bowler",
                "batting_style": "Left Handed Bat",
                "bowling_style": "Right-arm fast-medium"
            },
            {
                "id": "9f98de11-7764-4394-93e3-89f8c05ad378",
                "name": "Satyanarayana Raju",
                "role": "Bowler",
                "batting_style": "Right Handed Bat",
                "bowling_style": "Right-arm fast-medium"
            },
            {
                "id": "c8864ac7-af66-4719-8100-9dd9fd7e60f3",
                "name": "Mujeeb Ur Rahman",
                "role": "Bowler",
                "batting_style": "Right Handed Bat",
                "bowling_style": "Right-arm offbreak"
            },
            {
                "id": "7e9dc8b1-c44c-44f1-8663-cc42bad7709b",
                "name": "Reece Topley",
                "role": "Bowler",
                "batting_style": "Right Handed Bat",
                "bowling_style": "Left-arm fast-medium"
            },
            {
                "id": "237a1ef2-1eae-4877-8b94-d20d84faf635",
                "name": "Deepak Chahar",
                "role": "Bowler",
                "batting_style": "Right Handed Bat",
                "bowling_style": "Right-arm fast-medium"
            },
            {
                "id": "6602d875-cf56-46a3-866c-de80aaa006bc",
                "name": "Jasprit Bumrah",
                "role": "Bowler",
                "batting_style": "Right Handed Bat",
                "bowling_style": "Right-arm fast"
            },
            {
                "id": "0e2b638b-e356-41bf-b986-f0f0f84bad38",
                "name": "Vignesh Puthur",
                "role": "Bowler",
                "batting_style": "Right Handed Bat",
                "bowling_style": "Left-arm wrist-spin"
            },
            {
                "id": "af485f9b-d446-41ab-a644-f1a69f0eb600",
                "name": "Ashwani Kumar",
                "role": "Bowler",
                "batting_style": "Left Handed Bat",
                "bowling_style": "Left-arm fast-medium"
            },
            {
                "id": "6ceed869-d2b7-4707-b6fd-cb84419cda12",
                "name": "Arjun Tendulkar",
                "role": "Bowling Allrounder",
                "batting_style": "Left Handed Bat",
                "bowling_style": "Left-arm fast-medium"
            },
            {
                "id": "16ec245b-022d-4104-bd8f-ccc780428390",
                "name": "Mitchell Santner",
                "role": "Bowling Allrounder",
                "batting_style": "Left Handed Bat",
                "bowling_style": "Left-arm orthodox"
            },
            {
                "id": "e1dbe0b6-1662-4a8b-80aa-5ed066ddc0fe",
                "name": "Krishnan Shrijith",
                "role": "WK-Batsman",
                "batting_style": "Left Handed Bat",
                "bowling_style": "--"
            },
            {
                "id": "a6686871-5bcd-4aae-8bfc-8298f878b6a9",
                "name": "Ryan Rickelton",
                "role": "WK-Batsman",
                "batting_style": "Left Handed Bat",
                "bowling_style": "--"
            },
            {
                "id": "21ffa053-b03d-4270-a49f-d3e2db9dfde7",
                "name": "Robin Minz",
                "role": "WK-Batsman",
                "batting_style": "Left Handed Bat",
                "bowling_style": "Right-arm offbreak"
            }
        ]
    },
    "info": {
        "id": "team_ndpwtC34Z2eMiYMUUqp1YR8Xr",
        "timestamp_utc": "2025-05-17 13:58:23",
        "version": "v1.0",
        "credits_used": 5,
        "response_time": 151.86
    }
}
```

{% endtab %}

{% tab title="401" %}

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

{% endtab %}
{% endtabs %}