---
title: "Query Stats Data"
method: POST
path: "/stats"
tags: ["Stats"]
---

# Query Stats Data

`POST /stats`

## Request

- Base URL: `https://connect-au.catapultsports.com/api/v6`
- URL: `https://connect-au.catapultsports.com/api/v6/stats`
- Auth: HTTP bearer

## Request body

- object
  - `filters` object[]: Limit the stats returned
    - `name` string: Field to filter on
    - `comparison` '=' | '<>' | '>' | '>=' | '<' | '<=': Type of comparison to use
    - `values` union[]: Values to apply to the comparison
      - union
        - string
        - number
  - `group_by` string[]: Group by
  - `parameters` string[]: Parameters to include in each row of stats
  - `sorting` string[]: List of parameters to sort by
  - `source` 'cached_stats' | 'annotation_stats': Stats source
  - `requested_only` boolean: Return only the values indicated in parameters input

## Response `200`

List of stats

- object[]
  - `errors` object: Details of any errors encountered while calculating parameters, *indexed by parameter name*

## Other responses

- `401`: Unauthenticated

---

[API](https://skmtc.dev/catapultsports/apis/openfield-connect-v6-api.md) - [All operations](https://skmtc.dev/catapultsports/apis/openfield-connect-v6-api/llms.txt) - [OpenAPI document](https://skmtc.dev/catapultsports/apis/openfield-connect-v6-api/revisions/4f0d7082f399?raw)