> For the complete documentation index, see [llms.txt](https://docs.sportmonks.com/v2/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sportmonks.com/v2/cricket-api/our-api/team-rankings/get-global-team-rankings.md).

# GET Global Team Rankings

### `GET` Global Team Rankings

```
https://cricket.sportmonks.com/api/v2.0/team-rankings
```

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

{% hint style="info" %}
Add \&filter\[tournament\_type]=TEST\&filter\[gender]=men to only get men's TEST results.
{% endhint %}

#### 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. |
| 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.             |

**Sort**

You can sort on all fields.

#### Include options

`teams` `league` `fixtures`<br>

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="/pages/-MTeYiIp3JNsC4Lao5Nm" %}
[Enriching your response](/v2/cricket-api/getting-started/enriching-your-response.md)
{% endcontent-ref %}

#### Example Response

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

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

{% endtab %}

{% tab title="Response" %}

```javascript
   "data": [
        {
            "resource": "rankings",
            "type": "TEST",
            "position": null,
            "points": null,
            "rating": null,
            "gender": "men",
            "updated_at": "2021-07-18T18:30:45.000000Z",
            "team": [
                {
                    "resource": "teams",
                    "id": 42,
                    "name": "New Zealand",
                    "code": "NZL",
                    "image_path": "https://cdn.sportmonks.com/images/cricket/teams/10/42.png",
                    "country_id": 190324,
                    "national_team": true,
                    "position": 1,
                    "updated_at": "2019-08-31T12:32:06.000000Z",
                    "ranking": {
                        "position": 1,
                        "matches": 22,
                        "points": 2764,
                        "rating": 126
                    }
                },
                {
                    "resource": "teams",
                    "id": 10,
                    "name": "India",
                    "code": "IND",
                    "image_path": "https://cdn.sportmonks.com/images/cricket/teams/10/10.png",
                    "country_id": 190324,
                    "national_team": true,
                    "position": 2,
                    "updated_at": "2018-11-29T11:47:20.000000Z",
                    "ranking": {
                        "position": 2,
                        "matches": 25,
                        "points": 2987,
                        "rating": 119
                    }
                },
                {
                    "resource": "teams",
                    "id": 36,
                    "name": "Australia",
                    "code": "AUS",
                    "image_path": "https://cdn.sportmonks.com/images/cricket/teams/4/36.png",
                    "country_id": 190324,
                    "national_team": true,
                    "position": 3,
                    "updated_at": "2018-11-29T11:47:20.000000Z",
                    "ranking": {
                        "position": 3,
                        "matches": 17,
                        "points": 1844,
                        "rating": 108
                    }
                },
                {
                    "resource": "teams",
                    "id": 38,
                    "name": "England",
                    "code": "ENG",
                    "image_path": "https://cdn.sportmonks.com/images/cricket/teams/6/38.png",
                    "country_id": 190324,
                    "national_team": true,
                    "position": 4,
                    "updated_at": "2019-01-29T11:07:04.000000Z",
                    "ranking": {
                        "position": 4,
                        "matches": 35,
                        "points": 3753,
                        "rating": 107
                    }
                },
                {
                    "resource": "teams",
                    "id": 1,
                    "name": "Pakistan",
                    "code": "PAK",
                    "image_path": "https://cdn.sportmonks.com/images/cricket/teams/1/1.png",
                    "country_id": 190324,
                    "national_team": true,
                    "position": 5,
                    "updated_at": "2018-11-29T11:47:20.000000Z",
                    "ranking": {
                        "position": 5,
                        "matches": 24,
                        "points": 2247,
                        "rating": 94
                    }
                },
```

{% endtab %}
{% endtabs %}
