---
title: "Descriptive statistics for a list of numbers"
method: POST
path: "/stats.php"
tags: ["data"]
---

# Descriptive statistics for a list of numbers

`POST /stats.php`

## Request

- Base URL: `https://mate.tools/api/v1`
- URL: `https://mate.tools/api/v1/stats.php`
- Auth: none declared

Computes count, sum, mean, median, mode(s), min, max, range, variance (population + sample), stddev (population + sample), MAD, quartiles, IQR, percentiles (1,5,10,25,50,75,90,95,99), geometric & harmonic means.

## Request body

- object
  - `numbers` union, required
    - number[]
    - string

## Response `200`

Success

## Other responses

- `400`: Malformed request
- `413`: Request body or text exceeds 1 MB
- `429`: Rate limit exceeded (60/min, 600/hour per IP). Includes Retry-After header.

---

[API](https://skmtc.dev/mate/apis/mate-tools-api.md) · [All operations](https://skmtc.dev/mate/apis/mate-tools-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mate/apis/mate-tools-api/revisions/874670b78962?raw)