---
title: "Calculadora de Média Escolar (Aritmética e Ponderada)"
method: POST
path: "/api/v1/calc/media-escolar"
tags: ["calc", "educacao"]
---

# Calculadora de Média Escolar (Aritmética e Ponderada)

`POST /api/v1/calc/media-escolar`

## Request

- Base URL: `https://api.calculas.com.br`
- URL: `https://api.calculas.com.br/api/v1/calc/media-escolar`
- Auth: HTTP bearer

Calcula média escolar simples ou ponderada (com pesos diferentes por avaliação). Mostra se passou e quanto precisa nas próximas para alcançar a média.

## Request body

- object
  - `notas` object[], required: Lista de avaliações com nota e peso. Mínimo 1, máximo 20 avaliações. Cada item tem o valor da nota (0-100) e o peso da avaliação.
    - `valor` number, required: Nota obtida na avaliação, de 0 a 100. Exemplo: 7.5 para sete e meio.
    - `peso` number: Peso desta avaliação no cálculo da média ponderada. Faixa: 0,1 a 10. Exemplo: prova final com peso 4, trabalho com peso 1. Padrão: 1 (todas as notas com mesmo peso).
  - `mediaMinima` number: Nota média mínima exigida para aprovação, de 0 a 100. Exemplo: 60 significa que é preciso atingir pelo menos 6,0 para passar. Padrão: 60.
  - `formula` 'aritmetica' | 'ponderada': Fórmula de cálculo da média. aritmetica = soma das notas dividida pela quantidade (todos os pesos valem 1); ponderada = soma de (nota × peso) dividida pela soma dos pesos (cada avaliação pode ter peso diferente). Padrão: aritmetica.
  - `currentDate` string, date-time: ISO-8601 com offset. Default: tempo do servidor. Use pra reprodutibilidade / cache semantico.

## Response `200`

OK

- object
  - `ok` true, required
  - `data` object, required: Resultado dependente da calc — ver schema individual
  - `meta` object

## Other responses

- `422`: Input invalido (Zod parse falhou)
- `500`: Engine error

---

[API](https://skmtc.dev/calculas/apis/contai-api.md) · [All operations](https://skmtc.dev/calculas/apis/contai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/calculas/apis/contai-api/revisions/26a00749292b?raw)