> For the complete documentation index, see [llms.txt](https://speaking-test-docs.speechace.com/speechace-speaking-test/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://speaking-test-docs.speechace.com/speechace-speaking-test/speechace-workspaces-create-manage-and-share-speaking-assessments/creating-assessments/scoring-logic/scoring-with-maximum-scores.md).
# Scoring with Maximum Scores
Let us consider an example where individual [maximum scores](/speechace-speaking-test/speechace-workspaces-create-manage-and-share-speaking-assessments/creating-assessments/custom-assessments/speaking-and-writing-assessments/assessment-configurations/weights-max-scores-timers.md) are set for 5 questions, as shown in the image below.
The above configuration not only specifies the maximum possible score for a question but also caps the maximum possible score for the assessment. In the below paragraphs, we explain the logic behind each of these calculations.
#### Maximum possible score for assessment
The maximum possible score for the assessment is calculated by taking a simple average of all the maximum scores set for each individual question.
As shown in the above example, the maximum scores for 5 questions are set as 8.5, 8.0, 6.5, 5.5 and 9.0 out of 9.0. Therefore the maximum possible score for this assessment will be 7.5 out of 9.0 as per the calculation below:
$$
(8.5+8.0+6.5+5.5+9.0)/5=7.5
$$
No attempt for this assessment will ever have a score > 7.5.
#### Scoring an attempt
When an attempt is made on the assessment, the score for each question is capped by its specified maximum score. The overall attempt score is then calculated by taking a simple average of the score on all questions as illustrated in the formula:
`Score` = Sum of (`Question score`) / `total questions to be scored`
For an example, if the attempt scores for the 5 questions are 8.0, 6.0, 6.0, 5.0 and 8.0 out of 9.0 then the final assessment score will be 6.6 out of 9.0 as per the calculation below:
$$
(8.0+6.0+6.0+5.0+8.0)/5=6.6
$$
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://speaking-test-docs.speechace.com/speechace-speaking-test/speechace-workspaces-create-manage-and-share-speaking-assessments/creating-assessments/scoring-logic/scoring-with-maximum-scores.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.