---
title: "Calculate Ranking Coefficients"
method: POST
path: "/api/v1/calibration/calculate"
tags: ["Calibration"]
---

# Calculate Ranking Coefficients

`POST /api/v1/calibration/calculate`

## Request

- Base URL: `https://app.aimrank.io` (the document declares no server; this is the origin it was published from)
- URL: `https://app.aimrank.io/api/v1/calibration/calculate`
- Auth: none declared

Calculate optimal coefficients from questionnaire answers.

Returns recommended coefficients and a confidence score.
These coefficients can be applied when creating a ranking.

## Request body

- QuestionnaireAnswers: User answers to the questionnaire.
  - `domain_type` string, required: Q1: What are you ranking?
  - `change_speed` string, required: Q2: How often rankings change
  - `prior_knowledge` string, required: Q3: How well you know items
  - `win_types` string, required: Q4: Are some wins bigger
  - `upset_importance` string, required: Q5: Underdog value
  - `freshness` string, required: Q6: Does activity matter
  - `confidence_speed` string, required: Q7: Votes until trusted
  - `ties_allowed` string, required: Q8: Can comparisons tie

## Response `200`

Successful Response

- CoefficientCalculationResult: Result of coefficient calculation from questionnaire.
  - `coefficients` object, required
  - `domain_type` string, required
  - `calibration_source` string
  - `confidence_score` number, required: 0-1 confidence in calibration
  - `recommendations` string[], required
  - `summary` string, required: Human-readable summary of the calibration.

## Other responses

- `422`: Validation Error

---

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