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

# Test Grade Calculator

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

## Request

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

Turn a number of questions and a number of wrong answers into a percentage and a letter grade, with a chart pricing every possible number of wrong answers on that test. The letter cutoffs default to the US ten point scale and can be replaced.

## Request body

- object
  - `questions` integer
  - `wrong` integer
  - `scale` object
    - `a` integer
    - `b` integer
    - `c` integer
    - `d` integer

## Response `200`

Successful result

- object
  - `ok` boolean
  - `data` object
    - `questions` integer
    - `wrong` integer
    - `correct` integer
    - `score` integer
    - `letter` string
    - `scale` object
      - `a` integer
      - `b` integer
      - `c` integer
      - `d` integer
    - `chart` object[]
      - `wrong` integer
      - `score` integer
      - `letter` string

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