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

# Grade Calculator

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

## Request

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

Average the assessments of one course into the weighted grade it stands at, from each item's score and what it is worth. Divides by the weight actually entered, so a half-graded course reports the average so far rather than a score dragged down by work not handed in yet.

## Request body

- object
  - `items` object[]
    - `name` string
    - `score` integer
    - `weight` integer

## Response `200`

Successful result

- object
  - `ok` boolean
  - `data` object
    - `weightedAverage` integer
    - `totalWeight` integer
    - `remainingWeight` integer
    - `countedItems` integer
    - `items` object[]
      - `name` string
      - `score` integer
      - `weight` integer
      - `points` 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)