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

# Query Stats Data

`POST /stats`

## 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.net/catapultsports/apis/openfield-connect-v6-api.md) · [All operations](https://skmtc.net/catapultsports/apis/openfield-connect-v6-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/catapultsports/openfield-connect-v6-api/revisions/b68eadaba68c/schema)