---
title: "Grade Curve Calculator"
method: POST
path: "/api/v1/tools/grade-curve-calculator"
tags: ["tools"]
---

# Grade Curve Calculator

`POST /api/v1/tools/grade-curve-calculator`

## Request

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

Curve a set of test scores by one of the three methods teachers use: add the same points to everyone, take the square root and multiply by ten, or scale the highest score in the room up to 100. Returns every adjusted score plus the class mean, median, minimum and maximum before and after.

## Request body

- object
  - `scores` integer[]
  - `method` string
  - `flatPoints` integer
  - `capAt100` boolean

## Response `200`

Successful result

- object
  - `ok` boolean
  - `data` object
    - `method` string
    - `capAt100` boolean
    - `flatPoints` integer
    - `count` integer
    - `scores` object[]
      - `original` integer
      - `curved` number
    - `before` object
      - `mean` number
      - `median` number
      - `min` integer
      - `max` integer
    - `after` object
      - `mean` number
      - `median` number
      - `min` number
      - `max` number

## 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)