> For the complete documentation index, see [llms.txt](https://api-docs.speechace.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://api-docs.speechace.com/api-reference/score-speech-relevance/handling-relevance-response.md).

# Handling relevance response

The [pronunciation](/features/scripted-activities/pronunciation-scoring.md) and [fluency](/features/scripted-activities/fluency-scoring.md) interpretation of the key elements in the response of the spoken word or sentence remains the same as previously described. The parameter which we need to notice is the relevance check.&#x20;

**Relevance Check**

If the response is relevant, then `relevance.class` will be `TRUE`:

<div align="left"><figure><img src="/files/CmyAG4Ru4oqa3iohbABh" alt="" width="241"><figcaption></figcaption></figure></div>

If the response is not relevant to the `context`, then `relevance.class` will be `FALSE` and the error will be shown:

<div align="left"><figure><img src="/files/rWv0dx3mfNB883jQWrKX" alt="" width="563"><figcaption></figcaption></figure></div>

If the response is too similar to the question prompt, then the error will be as follows:

<div align="left"><figure><img src="/files/h3vSartwKWzOZ01GuQIU" alt="" width="563"><figcaption></figcaption></figure></div>

**Other fields**

<table><thead><tr><th width="187">Field</th><th>Description</th></tr></thead><tbody><tr><td>transcript</td><td>The speech-to-text transcript of what the user has said.</td></tr><tr><td>speechace_score</td><td>An overall score on a scale of 0 to 100, in addition to subscores for: Fluency, Pronunciation, Grammar, Vocabulary, Coherence.</td></tr><tr><td>ielts_score</td><td>An overall score on an IELTS scale of 0 to 9.0, in addition to subscores for: Fluency, Pronunciation, Grammar, Vocabulary, Coherence.</td></tr><tr><td>pte_score</td><td>An overall score on a PTE scale of 10 to 90, in addition to subscores for: Fluency, Pronunciation, Grammar, Vocabulary, Coherence.</td></tr><tr><td>cefr_score</td><td>An overall score on CEFR scale of A0 to C2, in addition to subscores for: Fluency, Pronunciation, Grammar, Vocabulary, Coherence.</td></tr><tr><td>toeic_score</td><td>An overall score on an TOEIC scale of 0 to 200, in addition to subscores for: Fluency, Pronunciation, Grammar, Vocabulary, Coherence.</td></tr><tr><td>relevance.class</td><td>TRUE or FALSE indicating whether the response was relevant given the <code>relevance_context</code> passed as input to the API.</td></tr></tbody></table>

{% hint style="info" %}
**Protip:** The `relevance_context` is an optional field and can be included only if the relevance of an audio response needs to be assessed by transcribing the response first and then comparing it to the provided question prompt.
{% endhint %}


---

# 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://api-docs.speechace.com/api-reference/score-speech-relevance/handling-relevance-response.md?ask=<question>&goal=<endgoal>
```

`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.
