> For the complete documentation index, see [llms.txt](https://docs.sportmonks.com/v3/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/v3/tutorials-and-guides/tutorials/statistics/statistics-types.md). # Statistics types ## A brief introduction about types We introduced [states](/v3/endpoints-and-entities/endpoints/states.md) and [types](/v3/definitions/types.md) to ensure data quality and consistency for specific fields. Something has a type when there are multiple variants of a particular variant. Sounds difficult? Let's explain with an example: {% hint style="info" %} Hint: you can request all possible types with their unique id via the types endpoint: {% endhint %} ### Fixture statistics As you’ve learned in our [includes tutorial](/v3/tutorials-and-guides/tutorials/includes.md), you can quickly enrich your request by using includes. You can obtain the statistics for your favourite fixture by adding the `&include=statistics` to your request. So, for example, the Celtic vs. Rangers fixture: ```javascript https://api.sportmonks.com/v3/football/fixtures/18535517?api_tokenYOUR_TOKEN&include=statistics ```
Response ```javascript { "data": { "id": 18535517, "sport_id": 1, "league_id": 501, "season_id": 19735, "stage_id": 77457866, "group_id": null, "aggregate_id": null, "round_id": 274719, "state_id": 5, "venue_id": 8909, "name": "Celtic vs Rangers", "starting_at": "2022-09-03 11:30:00", "result_info": "Celtic won after full-time.", "leg": "1/1", "details": null, "length": 90, "placeholder": false, "last_processed_at": "2023-03-02 17:47:38", "has_odds": true, "starting_at_timestamp": 1662204600, "statistics": [ { "id": 5914502, "fixture_id": 18535517, "type_id": 86, "participant_id": 53, "data": { "value": 6 }, "location": "home" }, { "id": 5914520, "fixture_id": 18535517, "type_id": 78, "participant_id": 62, "data": { "value": 17 }, "location": "away" }, //And More ```
This request returns all the match statistics of both teams for the requested fixture. As you might have noticed, you receive a lot of values belonging to different type ids. What does this mean exactly? Just add the nested `&include=statistics.type` to receive a textual representation: ```javascript https://api.sportmonks.com/v3/football/fixtures/18535517?api_token=YOUR_TOKEN&include=statistics.type ```
Response ```javascript { "data": { "id": 18535517, "sport_id": 1, "league_id": 501, "season_id": 19735, "stage_id": 77457866, "group_id": null, "aggregate_id": null, "round_id": 274719, "state_id": 5, "venue_id": 8909, "name": "Celtic vs Rangers", "starting_at": "2022-09-03 11:30:00", "result_info": "Celtic won after full-time.", "leg": "1/1", "details": null, "length": 90, "placeholder": false, "last_processed_at": "2023-03-02 17:47:38", "has_odds": true, "starting_at_timestamp": 1662204600, "statistics": [ { "id": 5914502, "fixture_id": 18535517, "type_id": 86, "participant_id": 53, "data": { "value": 6 }, "location": "home", "type": { "id": 86, "name": "Shots On Target", "code": "shots-on-target", "developer_name": "SHOTS_ON_TARGET", "model_type": "statistic", "stat_group": "offensive" } }, { "id": 5914520, "fixture_id": 18535517, "type_id": 78, "participant_id": 62, "data": { "value": 17 }, "location": "away", "type": { "id": 78, "name": "Tackles", "code": "tackles", "developer_name": "TACKLES", "model_type": "statistic", "stat_group": "defensive" } }, //And more ```
Now you can distinguish between the various match statistics for both teams. Interested in an overview of all statistics types? Check our [statistics types](/v3/definitions/types.md) overview page. {% hint style="danger" %} Including `.type` is not recommended as an include on any endpoint. Types are used throughout the entire API. We recommend retrieving all types from the types endpoint and storing them in your database or other data structure. Only include the type if no other option is available or when testing the API. {% endhint %} ### See also #### Related tutorials * [Fixture Statistics](https://docs.sportmonks.com/v3/tutorials-and-guides/tutorials/statistics/fixture-statistics) - Learn how to retrieve match statistics * [Player Statistics](https://docs.sportmonks.com/v3/tutorials-and-guides/tutorials/statistics/players-statistics) - Access individual player stats * [Season Statistics](https://docs.sportmonks.com/v3/tutorials-and-guides/tutorials/statistics/season-statistics) - Get league-wide statistics * [Team Statistics](https://docs.sportmonks.com/v3/tutorials-and-guides/tutorials/statistics/team-statistics) - Retrieve team performance data #### Reference * [Statistics Types List](https://docs.sportmonks.com/v3/definitions/types/statistics) - Complete reference of all statistic type IDs and descriptions * [Includes Tutorial](https://docs.sportmonks.com/v3/tutorials-and-guides/tutorials/includes) - Learn how to use nested includes for type data #### Best practices * [Filter and Select Fields](https://docs.sportmonks.com/v3/tutorials-and-guides/tutorials/filter-and-select-fields) - Filter statistics by specific type IDs
--- # 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.sportmonks.com/v3/tutorials-and-guides/tutorials/statistics/statistics-types.md?ask=&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.