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

# All endpoints

On this page you can find an overview of all the endpoints.

{% hint style="info" %}
Please note that our entire Cricket API collection with all endpoints is available in Postman. [![Run in Postman](https://docs.sportmonks.com/~gitbook/image?url=https%3A%2F%2Frun.pstmn.io%2Fbutton.svg\&width=300\&dpr=4\&quality=100\&sign=5f4dbf4c\&sv=2)](https://cricket-postman.sportsapi360.com/)
{% endhint %}

#### Match Endpoints

**GET Match Fixtures**

`GET {{baseUrl}}/cricket/v1/matches`

Retrieve a paginated, filterable list of cricket matches.

| Parameter   | Type  | Required | Description                                     |
| ----------- | ----- | -------- | ----------------------------------------------- |
| `api_key`   | query | Yes      | API access token                                |
| `status`    | query | No       | `live`, `completed`, `upcoming`                 |
| `format`    | query | No       | `t20`, `t20i`, `odi`, `test`, `t10`, `woment20` |
| `date_from` | query | No       | Start date `yyyy-mm-dd`                         |
| `date_to`   | query | No       | End date `yyyy-mm-dd`                           |
| `series_id` | query | No       | Filter by series ID                             |
| `limit`     | query | No       | Results per page                                |
| `page`      | query | No       | Page number                                     |

***

**GET Match Details**

`GET {{baseUrl}}/cricket/v1/matches/:id`

Retrieve full metadata for a specific match.

| Parameter | Type  | Required | Description                   |
| --------- | ----- | -------- | ----------------------------- |
| `id`      | path  | Yes      | Match ID — use `{{match_id}}` |
| `api_key` | query | Yes      | API access token              |

***

**GET Match Scorecard**

`GET {{baseUrl}}/cricket/v1/matches/:id/scorecard`

Retrieve the full innings-by-innings scorecard including batting, bowling, fall of wickets, and extras.

| Parameter | Type  | Required | Description                   |
| --------- | ----- | -------- | ----------------------------- |
| `id`      | path  | Yes      | Match ID — use `{{match_id}}` |
| `api_key` | query | Yes      | API access token              |

***

**GET Match Squads**

`GET {{baseUrl}}/cricket/v1/matches/:id/squad`

Retrieve playing squads for both teams in a match.

| Parameter | Type  | Required | Description                   |
| --------- | ----- | -------- | ----------------------------- |
| `id`      | path  | Yes      | Match ID — use `{{match_id}}` |
| `api_key` | query | Yes      | API access token              |

***

**GET Match Live**

`GET {{baseUrl}}/cricket/v1/matches/:id/live`

Retrieve real-time live score, active batsmen, and current bowler figures.

| Parameter | Type  | Required | Description                   |
| --------- | ----- | -------- | ----------------------------- |
| `id`      | path  | Yes      | Match ID — use `{{match_id}}` |
| `api_key` | query | Yes      | API access token              |

***

**GET Match Statistics**

`GET {{baseUrl}}/cricket/v1/matches/:id/statistics`

Retrieve aggregated batting and bowling statistics for all players in a match.

| Parameter | Type  | Required | Description                   |
| --------- | ----- | -------- | ----------------------------- |
| `id`      | path  | Yes      | Match ID — use `{{match_id}}` |
| `api_key` | query | Yes      | API access token              |

***

**GET Match Commentary**

`GET {{baseUrl}}/cricket/v1/matches/:id/commentary`

Retrieve ball-by-ball commentary with optional highlight and innings filtering.

| Parameter   | Type  | Required | Description                                   |
| ----------- | ----- | -------- | --------------------------------------------- |
| `id`        | path  | Yes      | Match ID — use `{{match_id}}`                 |
| `api_key`   | query | Yes      | API access token                              |
| `innings`   | query | No       | Innings number (`1`, `2`)                     |
| `highlight` | query | No       | Event filter: `4`, `6`, `w` (comma-separated) |
| `page`      | query | No       | Page number                                   |
| `limit`     | query | No       | Results per page                              |

***

**GET Match Over By Overs**

`GET {{baseUrl}}/cricket/v1/matches/:id/overs_by_overs`

Retrieve per-over run breakdown with optional innings and over number filtering.

| Parameter | Type  | Required | Description                   |
| --------- | ----- | -------- | ----------------------------- |
| `id`      | path  | Yes      | Match ID — use `{{match_id}}` |
| `api_key` | query | Yes      | API access token              |
| `innings` | query | No       | Innings number                |
| `over`    | query | No       | Specific over number          |
| `page`    | query | No       | Page number                   |
| `limit`   | query | No       | Results per page              |

***

**GET Match Head2Head**

`GET {{baseUrl}}/cricket/v1/matches/:id/h2h`

Retrieve historical head-to-head record between the two teams in a match.

| Parameter | Type  | Required | Description                   |
| --------- | ----- | -------- | ----------------------------- |
| `id`      | path  | Yes      | Match ID — use `{{match_id}}` |
| `api_key` | query | Yes      | API access token              |

***

**GET Match Team Forms**

`GET {{baseUrl}}/cricket/v1/matches/:id/team_forms`

Retrieve recent form (W/L/D/NR) for both teams in a match.

| Parameter | Type  | Required | Description                   |
| --------- | ----- | -------- | ----------------------------- |
| `id`      | path  | Yes      | Match ID — use `{{match_id}}` |
| `api_key` | query | Yes      | API access token              |

***

#### Series Endpoints

**GET Series Schedules**

`GET {{baseUrl}}/cricket/v1/series`

Retrieve a paginated list of series with optional filters.

| Parameter  | Type  | Required | Description                                                    |
| ---------- | ----- | -------- | -------------------------------------------------------------- |
| `api_key`  | query | Yes      | API access token                                               |
| `status`   | query | No       | `live`, `completed`, `upcoming`                                |
| `format`   | query | No       | `odi`, `test`, `t20i`                                          |
| `category` | query | No       | `international`, `domestic`, `t20league`, `t10league`, `women` |
| `season`   | query | No       | Season year e.g. `2026`                                        |
| `country`  | query | No       | Country name e.g. `india`                                      |
| `limit`    | query | No       | Results per page                                               |
| `page`     | query | No       | Page number                                                    |

***

**GET Series Details**

`GET {{baseUrl}}/cricket/v1/series/:id`

Retrieve full metadata for a specific series.

| Parameter | Type  | Required | Description                     |
| --------- | ----- | -------- | ------------------------------- |
| `id`      | path  | Yes      | Series ID — use `{{series_Id}}` |
| `api_key` | query | Yes      | API access token                |

***

**GET Series Squads**

`GET {{baseUrl}}/cricket/v1/series/:id/squads`

Retrieve squads for all teams in a series.

| Parameter | Type  | Required | Description                     |
| --------- | ----- | -------- | ------------------------------- |
| `id`      | path  | Yes      | Series ID — use `{{series_Id}}` |
| `api_key` | query | Yes      | API access token                |

***

**GET Series Standings**

`GET {{baseUrl}}/cricket/v1/series/:id/standings`

Retrieve the points table for a series.

| Parameter | Type  | Required | Description                     |
| --------- | ----- | -------- | ------------------------------- |
| `id`      | path  | Yes      | Series ID — use `{{series_Id}}` |
| `api_key` | query | Yes      | API access token                |

***

**GET Series Stats Type Lists**

`GET {{baseUrl}}/cricket/v1/series/stats-types`

Retrieve all available stats type slugs and IDs. Call this first before querying series stats.

| Parameter | Type  | Required | Description      |
| --------- | ----- | -------- | ---------------- |
| `api_key` | query | Yes      | API access token |

***

**GET Series Stats**

`GET {{baseUrl}}/cricket/v1/series/:id/stats`

Retrieve aggregated player stats across all matches in a series.

| Parameter | Type  | Required | Description                     |
| --------- | ----- | -------- | ------------------------------- |
| `id`      | path  | Yes      | Series ID — use `{{series_Id}}` |
| `api_key` | query | Yes      | API access token                |

***

**GET Series Stats by Type**

`GET {{baseUrl}}/cricket/v1/series/:id/stats/:stats_type`

Retrieve series stats filtered by a specific stats type.

| Parameter    | Type  | Required | Description                             |
| ------------ | ----- | -------- | --------------------------------------- |
| `id`         | path  | Yes      | Series ID — use `{{series_Id}}`         |
| `stats_type` | path  | Yes      | Stats type slug — use `{{stats_type}}`  |
| `api_key`    | query | Yes      | API access token                        |
| `format`     | query | No       | Match format e.g. `t20i`, `odi`, `test` |
| `limit`      | query | No       | Max results to return                   |

***

**GET Series Stats All**

`GET {{baseUrl}}/cricket/v1/series/:id/stats_all`

Retrieve series stats with combined player, team, and format filters.

| Parameter       | Type  | Required | Description                               |
| --------------- | ----- | -------- | ----------------------------------------- |
| `id`            | path  | Yes      | Series ID — use `{{series_Id}}`           |
| `api_key`       | query | Yes      | API access token                          |
| `stats_type_id` | query | No       | Stats type UUID — use `{{stats_type_id}}` |
| `player_id`     | query | No       | Player ID — use `{{stats_player_id}}`     |
| `team_id`       | query | No       | Team ID — use `{{stats_team_id}}`         |
| `format`        | query | No       | Match format e.g. `t20i`                  |

***

#### Team Endpoints

**GET Team List**

`GET {{baseUrl}}/cricket/v1/teams`

Retrieve a paginated, searchable list of cricket teams.

| Parameter       | Type  | Required | Description                         |
| --------------- | ----- | -------- | ----------------------------------- |
| `api_key`       | query | Yes      | API access token                    |
| `q`             | query | No       | Search by name or short name        |
| `country`       | query | No       | 2-letter ISO country code e.g. `au` |
| `gender`        | query | No       | `male`, `female`                    |
| `international` | query | No       | `true`, `false`                     |
| `is_league`     | query | No       | `true`, `false`                     |
| `type`          | query | No       | `country`, `club`                   |
| `page`          | query | No       | Page number                         |
| `limit`         | query | No       | Results per page                    |

***

**GET Team Details**

`GET {{baseUrl}}/cricket/v1/teams/:id`

Retrieve the full profile for a specific team.

| Parameter | Type  | Required | Description                 |
| --------- | ----- | -------- | --------------------------- |
| `id`      | path  | Yes      | Team ID — use `{{team_id}}` |
| `api_key` | query | Yes      | API access token            |

***

**GET Team Players**

`GET {{baseUrl}}/cricket/v1/teams/:id/players`

Retrieve the full roster of players for a specific team.

| Parameter | Type  | Required | Description                 |
| --------- | ----- | -------- | --------------------------- |
| `id`      | path  | Yes      | Team ID — use `{{team_id}}` |
| `api_key` | query | Yes      | API access token            |

***

**GET Team Recent Matches**

`GET {{baseUrl}}/cricket/v1/teams/:id/recent_matches`

Retrieve the most recent matches played by a specific team.

| Parameter | Type  | Required | Description                 |
| --------- | ----- | -------- | --------------------------- |
| `id`      | path  | Yes      | Team ID — use `{{team_id}}` |
| `api_key` | query | Yes      | API access token            |

***

#### Player Endpoints

**GET Player List**

`GET {{baseUrl}}/cricket/v1/players`

Retrieve a paginated, searchable list of cricket players.

| Parameter | Type  | Required | Description                         |
| --------- | ----- | -------- | ----------------------------------- |
| `api_key` | query | Yes      | API access token                    |
| `q`       | query | No       | Search by player name               |
| `country` | query | No       | 2-letter ISO country code e.g. `in` |
| `gender`  | query | No       | `male`, `female`                    |
| `page`    | query | No       | Page number                         |
| `limit`   | query | No       | Results per page                    |

***

**GET Player Details**

`GET {{baseUrl}}/cricket/v1/players/:id`

Retrieve the full profile for a specific player.

| Parameter | Type  | Required | Description                     |
| --------- | ----- | -------- | ------------------------------- |
| `id`      | path  | Yes      | Player ID — use `{{player_id}}` |
| `api_key` | query | Yes      | API access token                |

***

**GET Player Stats**

`GET {{baseUrl}}/cricket/v1/players/:id/stats`

Retrieve career and format-wise batting and bowling statistics for a player.

| Parameter | Type  | Required | Description                     |
| --------- | ----- | -------- | ------------------------------- |
| `id`      | path  | Yes      | Player ID — use `{{player_id}}` |
| `api_key` | query | Yes      | API access token                |

***

**GET Player Recent Matches**

`GET {{baseUrl}}/cricket/v1/players/:id/recent_matches`

Retrieve the most recent matches played by a specific player with their individual performance.

| Parameter | Type  | Required | Description                     |
| --------- | ----- | -------- | ------------------------------- |
| `id`      | path  | Yes      | Player ID — use `{{player_id}}` |
| `api_key` | query | Yes      | API access token                |

***

#### Rankings Endpoints

**GET Team Rankings**

`GET {{baseUrl}}/cricket/v1/rankings`

Retrieve official ICC team rankings by format and gender.

| Parameter | Type  | Required | Description          |
| --------- | ----- | -------- | -------------------- |
| `api_key` | query | Yes      | API access token     |
| `type`    | query | Yes      | `Teams`              |
| `format`  | query | Yes      | `Odi`, `T20`, `Test` |
| `gender`  | query | Yes      | `men`, `women`       |
| `page`    | query | No       | Page number          |
| `limit`   | query | No       | Results per page     |

***

**GET Player Rankings**

`GET {{baseUrl}}/cricket/v1/rankings`

Retrieve official ICC player rankings by type, format, and gender.

| Parameter | Type  | Required | Description                         |
| --------- | ----- | -------- | ----------------------------------- |
| `api_key` | query | Yes      | API access token                    |
| `type`    | query | Yes      | `Batsmen`, `Bowlers`, `AllRounders` |
| `format`  | query | Yes      | `Odi`, `T20`, `Test`                |
| `gender`  | query | Yes      | `men`, `women`                      |
| `page`    | query | No       | Page number                         |
| `limit`   | query | No       | Results per page                    |

***


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.sportsapi360.com/cricket-docs/cricket-api/all-endpoints.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
