# GET All Players

### `GET` All Players

```
https://cricket.sportmonks.com/api/v2.0/players
```

| Endpoint details        |         |
| ----------------------- | ------- |
| Authorization           | API Key |
| Pagination              | NO      |
| Allowed nested includes | 10      |

#### Parameters

| Available parameters |                                                                                                                                                                            |
| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| include              | Enrich the API with more data and/or nested includes. Can be used by adding `&include=` etc. to your request url.                                                          |
| filter               | <p>Array of fields to filter on. Can be used by adding <code>\&filter\[{field you want to filter}].</code> <br>For example: <code>\&filter\[country\_id]=52126.</code></p> |
| fields\[object]      | Only return fields you are interested in. Simply add `&fields[object]=id,name,code`  to your request url.                                                                  |
| sort                 | One or comma separated list of fields to sort on. Can be used by adding `&sort=` to your request url.                                                                      |

**Filters**

`name` `country_id`

**Sort**

You can sort on all fields.

#### Include options

`career`

Includes are the cornerstone of our API and allow you to enrich and customize your requests. This flexibility is what distinguishes us from our competitors. &#x20;

You can learn more about what includes are and how they work here:

{% content-ref url="../../getting-started/enriching-your-response" %}
[enriching-your-response](https://docs.sportmonks.com/v2/cricket-api/getting-started/enriching-your-response)
{% endcontent-ref %}

#### Example response

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

```
https://cricket.sportmonks.com/api/v2.0/players?api_token={API_TOKEN}
```

{% endtab %}

{% tab title="Response" %}

```javascript
 "data": [
        {
            "resource": "players",
            "id": 2,
            "country_id": 52126,
            "firstname": "Ahmed",
            "lastname": "Shehzad",
            "fullname": "Ahmed Shehzad",
            "image_path": "https://cdn.sportmonks.com/images/cricket/players/2/2.png",
            "dateofbirth": "1991-11-23",
            "gender": "m",
            "battingstyle": "right-hand-bat",
            "bowlingstyle": "legbreak",
            "position": {
                "resource": "positions",
                "id": 1,
                "name": "Batsman"
            },
            "updated_at": "2020-03-31T05:00:31.000000Z"
        },
        {
            "resource": "players",
            "id": 3,
            "country_id": 52126,
            "firstname": "Anwar",
            "lastname": "Ali",
            "fullname": "Anwar Ali",
            "image_path": "https://cdn.sportmonks.com/images/cricket/players/3/3.png",
            "dateofbirth": "1987-11-25",
            "gender": "m",
            "battingstyle": "right-hand-bat",
            "bowlingstyle": "right-arm-fast-medium",
            "position": {
                "resource": "positions",
                "id": 2,
                "name": "Bowler"
            },
            "updated_at": "2020-12-14T18:58:56.000000Z"
        },
        {
            "resource": "players",
            "id": 4,
            "country_id": 52126,
            "firstname": "Sarfraz",
            "lastname": "Ahmed",
            "fullname": "Sarfraz Ahmed",
            "image_path": "https://cdn.sportmonks.com/images/cricket/players/4/4.png",
            "dateofbirth": "1987-05-22",
            "gender": "m",
            "battingstyle": "right-hand-bat",
            "bowlingstyle": "right-arm-offbreak",
            "position": {
                "resource": "positions",
                "id": 3,
                "name": "Wicketkeeper"
            },
            "updated_at": "2020-04-07T08:51:02.000000Z"
        },
        {
            "resource": "players",
            "id": 5,
            "country_id": 52126,
            "firstname": "Azhar",
            "lastname": "Ali",
            "fullname": "Azhar Ali",
            "image_path": "https://cdn.sportmonks.com/images/cricket/players/5/5.png",
            "dateofbirth": "1985-02-19",
            "gender": "m",
            "battingstyle": "right-hand-bat",
            "bowlingstyle": "legbreak",
            "position": {
                "resource": "positions",
                "id": 1,
                "name": "Batsman"
            },
            "updated_at": "2020-04-01T02:28:23.000000Z"
        },
        {
            "resource": "players",
            "id": 6,
            "country_id": 52126,
            "firstname": "Fakhar",
            "lastname": "Zaman",
            "fullname": "Fakhar Zaman",
            "image_path": "https://cdn.sportmonks.com/images/cricket/players/6/6.png",
            "dateofbirth": "1990-04-10",
            "gender": "m",
            "battingstyle": "left-hand-bat",
            "bowlingstyle": "slow-left-arm-orthodox",
            "position": {
                "resource": "positions",
                "id": 1,
                "name": "Batsman"
            },
            "updated_at": "2020-04-02T02:22:22.000000Z"
        },
```

{% endtab %}
{% endtabs %}