---
title: "Average Calculator"
method: POST
path: "/api/v1/tools/average-calculator"
tags: ["tools"]
---

# Average Calculator

`POST /api/v1/tools/average-calculator`

## Request

- Base URL: `https://toolforte.com`
- URL: `https://toolforte.com/api/v1/tools/average-calculator`
- Auth: HTTP bearer

Every average of a list of numbers in one call: mean, median, mode, sum, count, minimum, maximum, range, and the geometric and harmonic means. A list where nothing repeats has no mode, and the two positive-only means come back null when any value is zero or below.

## Request body

- object
  - `values` integer[]

## Response `200`

Successful result

- object
  - `ok` boolean
  - `data` object
    - `count` integer
    - `sum` integer
    - `mean` integer
    - `median` integer
    - `modes` integer[]
    - `min` integer
    - `max` integer
    - `range` integer
    - `geometricMean` number
    - `harmonicMean` number
    - `sorted` integer[]

## Other responses

- `400`: Missing or invalid request fields
- `401`: Invalid or missing API key
- `429`: Monthly plan limit reached

---

[API](https://skmtc.dev/toolforte/apis/toolforte-api.md) · [All operations](https://skmtc.dev/toolforte/apis/toolforte-api/llms.txt) · [OpenAPI document](https://skmtc.dev/toolforte/apis/toolforte-api/revisions/4d814d484dfc?raw)