> ## Documentation Index
> Fetch the complete documentation index at: https://docs.toolzz.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar Resultados de uma Prova Classificatória

> Este endpoint permite consultar os resultados de uma prova classificatória em um curso específico no Toolzz LMS.

## Parâmetros

<ParamField path="test_name" type="string" required>
  Nome da avaliação que será usada para a classificação.
</ParamField>

<ParamField query="course_id" type="int" required>
  ID do curso para o qual os resultados serão consultados.
</ParamField>

<Note>Para utilizar este recurso, é necessário ter a feature **"Provas Classificatórias"** ativada na plataforma.</Note>

<Note>Antes de utilizar este endpoint, certifique-se de possuir os seguintes parâmetros:</Note>

* **Token de Acesso** (obrigatório): Certifique-se de possuir um token de autenticação válido.
* **course\_id** (obrigatório): ID do curso para buscar os resultados.
* **test\_name** (obrigatório): Nome da avaliação usada na classificação.

## Descrição da Resposta

Abaixo está um exemplo da estrutura de resposta retornada por este endpoint.

<ResponseField name="status" type="number">
  Código de status da resposta.
</ResponseField>

<ResponseField name="data" type="array">
  Lista de usuários e seus resultados.

  <Expandable title="properties">
    <ResponseField name="id" type="number">
      Identificador único do usuário.
    </ResponseField>

    <ResponseField name="nome" type="string">
      Nome do usuário.
    </ResponseField>

    <ResponseField name="email" type="string">
      E-mail do usuário.
    </ResponseField>

    <ResponseField name="tentativas" type="array">
      Lista de tentativas do usuário.

      <Expandable title="properties">
        <ResponseField name="content_try_id" type="number">
          Identificador único da tentativa de conteúdo.
        </ResponseField>

        <ResponseField name="content_id" type="number">
          Identificador único do conteúdo.
        </ResponseField>

        <ResponseField name="course_id" type="number">
          Identificador do curso relacionado à tentativa.
        </ResponseField>

        <ResponseField name="score" type="number">
          Nota obtida na tentativa.
        </ResponseField>

        <ResponseField name="classification" type="string">
          Classificação baseada na nota.
        </ResponseField>

        <ResponseField name="try" type="number">
          Número da tentativa.
        </ResponseField>

        <ResponseField name="created_at" type="Date">
          Data de criação da tentativa.
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

## Segurança

Para acessar este endpoint, é necessário enviar um token de acesso válido no cabeçalho de autorização (**Authorization**) da requisição.\
A API conta com medidas adicionais de segurança para garantir a proteção dos dados dos usuários.