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

# Players List

Get a complete list of cricket players with their basic details, filtered by team or other parameters.

### 🧾 Retrieve the List of Cricket Players

This API returns a list of players from the cricket database. You can filter the list by team or player role to show batsmen, bowlers, or all-rounders. Use this to display player rosters, statistics, or team lineups.

## 🚀 How to get Players List

To get Players 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/players/list></kbd>

**Headers**

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

**Body**

| Name           | Type   | Description             |
| -------------- | ------ | ----------------------- |
| name           | string | search by name          |
| role           | string | search by player role   |
| batting\_style | string | search by batting style |
| bowling\_style | string | search by bowling style |
| country        | string | search by country       |

**Response**

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

```json
{
    "status": "success",
    "message": "Players list fetched successfully.",
    "code": 200,
    "type": "SUCCESS",
    "data": [
        {
            "id": "player_pgqJz1sgQK9C6CIUuyHB7SYJC",
            "name": "Ryan Drake",
            "role": "Bowler",
            "batting_style": "Right Handed Bat",
            "bowling_style": "Right-arm fast-medium",
            "country": "Japan"
        },
        {
            "id": "player_Z0lqpdJwXMdG9XtMGtWZk3Y0K",
            "name": "Kiefer Yamamoto-Lake",
            "role": "Bowling Allrounder",
            "batting_style": "Left Handed Bat",
            "bowling_style": "Right-arm medium",
            "country": "Japan"
        },
        {
            "id": "player_AlKJ59CTXthKP3Fs2LNVWBvZO",
            "name": "Ameesha Olacheri",
            "role": "Bowler",
            "batting_style": "Right Handed Bat",
            "bowling_style": "Right-arm offbreak",
            "country": "Kuwait"
        },
        {
            "id": "player_aTKjQUhK6mIc29rlLxaJtsKqV",
            "name": "Shing Chan Dorothea",
            "role": "Bowler",
            "batting_style": "Right Handed Bat",
            "bowling_style": "Right-arm legbreak",
            "country": "Hong Kong"
        },
        {
            "id": "player_P0EKZ56gcGOcDznYIxQCGZkTE",
            "name": "Mahirah Izzati Ismail",
            "role": "Bowler",
            "batting_style": "Right Handed Bat",
            "bowling_style": "Right-arm offbreak",
            "country": "Malaysia"
        },
        {
            "id": "player_7C0VtyeMbjcSpNcgJtFTxb4BA",
            "name": "Sudha Thapa",
            "role": "Batsman",
            "batting_style": "Right Handed Bat",
            "bowling_style": "--",
            "country": "Qatar"
        },
        {
            "id": "player_Mnzm2ojJWuhHzwadMWHldoMYO",
            "name": "Devanandha Kavinisseri",
            "role": "Bowler",
            "batting_style": "Right Handed Bat",
            "bowling_style": "Right-arm medium",
            "country": "Qatar"
        },
        {
            "id": "player_rIdqZiUTy09amXUVfAuE4HBz7",
            "name": "Sabeeja Panayan",
            "role": "Bowler",
            "batting_style": "Right Handed Bat",
            "bowling_style": "Right-arm offbreak",
            "country": "Qatar"
        },
        {
            "id": "player_joWglxWXny2fYtpMFrBrgOc14",
            "name": "Athige Silva",
            "role": "Bowler",
            "batting_style": "Right Handed Bat",
            "bowling_style": "Right-arm medium",
            "country": "United Arab Emirates"
        },
        {
            "id": "player_FtszqAV0mUPV4akjiSqnwLsij",
            "name": "Roheed Akhtar",
            "role": "Batting Allrounder",
            "batting_style": "Right Handed Bat",
            "bowling_style": "Right-arm medium",
            "country": "Qatar"
        },
        {
            "id": "player_FkvtwtIS3WsjuwgVuBXqXlHY8",
            "name": "Udeni Dona",
            "role": "Batsman",
            "batting_style": "Left Handed Bat",
            "bowling_style": "Right-arm medium",
            "country": "United Arab Emirates"
        },
        {
            "id": "player_OGm56KlySH04R9jdiXYQ02aSU",
            "name": "Katie Thompson",
            "role": "Batsman",
            "batting_style": "Right Handed Bat",
            "bowling_style": "--",
            "country": "United Arab Emirates"
        },
        {
            "id": "player_Gn7oA1Hm5wWbrOyEf61qTYtPS",
            "name": "Heena Hotchandani",
            "role": "Batsman",
            "batting_style": "Left Handed Bat",
            "bowling_style": "Left-arm orthodox",
            "country": "United Arab Emirates"
        },
        {
            "id": "player_HcoONhWaGXzNM8siTTUTGl8ol",
            "name": "Rinitha Rajith",
            "role": "Batsman",
            "batting_style": "Right Handed Bat",
            "bowling_style": "Right-arm fast-medium",
            "country": "United Arab Emirates"
        },
        {
            "id": "player_MNA1r3FrvZKYjyP2Z4doTJYma",
            "name": "Al Maseera Jahangir",
            "role": "Bowling Allrounder",
            "batting_style": "Right Handed Bat",
            "bowling_style": "Right-arm offbreak",
            "country": "United Arab Emirates"
        },
        {
            "id": "player_xaNkhFhjuHRvODd00UUDWs6Bg",
            "name": "Michelle Botha",
            "role": "Batting Allrounder",
            "batting_style": "Right Handed Bat",
            "bowling_style": "Left-arm orthodox",
            "country": "United Arab Emirates"
        },
        {
            "id": "player_UpiLjXL75ilE2mAnr5iSO6C6V",
            "name": "Keziah Miriam Sabin",
            "role": "--",
            "batting_style": "Left Handed Bat",
            "bowling_style": "--",
            "country": "United Arab Emirates"
        },
        {
            "id": "player_PWwzbTpu1bi0NJ9lwH5mgBJfl",
            "name": "Evangellia Grammenou",
            "role": "Bowling Allrounder",
            "batting_style": "Right Handed Bat",
            "bowling_style": "Right-arm medium",
            "country": "Greece"
        },
        {
            "id": "player_qq8k89gBa3RU97Kbs9nPANNWu",
            "name": "Alekcandra Kourkoulou",
            "role": "Bowler",
            "batting_style": "Left Handed Bat",
            "bowling_style": "--",
            "country": "Greece"
        },
        {
            "id": "player_erCN9B0wugathcqSuKuaPKEj7",
            "name": "Adamantia Makri",
            "role": "Batting Allrounder",
            "batting_style": "Right Handed Bat",
            "bowling_style": "Right-arm fast-medium",
            "country": "Greece"
        },
        {
            "id": "player_lEOZFxT9skoxqNqUTkTUPHlDR",
            "name": "Kapsokavadi Tereza",
            "role": "Batting Allrounder",
            "batting_style": "Left Handed Bat",
            "bowling_style": "--",
            "country": "Greece"
        },
        {
            "id": "player_w62Vhu9aWSHavfMU9SZBvwWi6",
            "name": "Ioanna Argyropolou",
            "role": "WK-Batsman",
            "batting_style": "Left Handed Bat",
            "bowling_style": "--",
            "country": "Greece"
        },
        {
            "id": "player_SKoMePTIbCb4DPOhetOxU89g7",
            "name": "Maria Syrioti",
            "role": "Bowling Allrounder",
            "batting_style": "Right Handed Bat",
            "bowling_style": "Right-arm medium",
            "country": "Greece"
        },
        {
            "id": "player_iXBtToUQjf5BGyY3KMi1ic4HG",
            "name": "Thalia Koula",
            "role": "--",
            "batting_style": "Right Handed Bat",
            "bowling_style": "--",
            "country": "Greece"
        },
        {
            "id": "player_0BQpCLXBn8QG1GnUWVVgiqVGL",
            "name": "Elpida Kallous",
            "role": "Batting Allrounder",
            "batting_style": "Right Handed Bat",
            "bowling_style": "Right-arm medium",
            "country": "Greece"
        }
    ],
    "info": {
        "total": 8222,
        "limit": 25,
        "offset": 0,
        "remaining": 8197,
        "timestamp_utc": "2025-05-17 13:58:59",
        "version": "v1.0",
        "credits_used": 3,
        "response_time": 157.96
    }
}
```

{% endtab %}

{% tab title="401" %}

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

{% endtab %}
{% endtabs %}