> ## 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 Avaliações

> Este endpoint permite listar as avaliações de uma instituição no Toolzz LMS.

## Parâmetros

<ParamField query="school_ids" type="string">
  IDs das escolas, separados por vírgula (sem espaços).
</ParamField>

<ParamField query="course_ids" type="string">
  IDs dos cursos, separados por vírgula (sem espaços).
</ParamField>

<ParamField query="tags" type="string">
  Lista de tags para filtrar as avaliações. Apenas as avaliações que possuírem as tags selecionadas serão retornadas.
</ParamField>

<ParamField query="page" type="string">
  Número da página para paginação.
</ParamField>

<ParamField query="page_size" type="string">
  Quantidade de registros por página.
</ParamField>

## Descrição da Resposta

Exemplo de resposta retornada por este endpoint:

<ResponseField name="data" type="array">
  Lista de avaliações.

  <Expandable title="properties">
    <ResponseField name="id" type="number">
      Identificador único da avaliação.
    </ResponseField>

    <ResponseField name="name" type="string">
      Nome da avaliação.
    </ResponseField>

    <ResponseField name="type" type="string">
      Tipo da avaliação.
    </ResponseField>

    <ResponseField name="schools" type="array">
      Lista de escolas associadas.

      <Expandable title="properties">
        <ResponseField name="id" type="number">
          Identificador único da escola.
        </ResponseField>

        <ResponseField name="name" type="string">
          Nome da escola.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="courses" type="array">
      Lista de cursos associados.

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

        <ResponseField name="name" type="string">
          Nome do curso.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="themes" type="array">
      Lista de temas associados.
    </ResponseField>

    <ResponseField name="total_questions" type="number">
      Quantidade total de questões na avaliação.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="links" type="object">
  Links de paginação.

  <Expandable title="properties">
    <ResponseField name="first" type="string">
      URL da primeira página.
    </ResponseField>

    <ResponseField name="last" type="string">
      URL da última página.
    </ResponseField>

    <ResponseField name="prev" type="string" nullable>
      URL da página anterior.
    </ResponseField>

    <ResponseField name="next" type="string" nullable>
      URL da próxima página.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="meta" type="object">
  Metadados da paginação.

  <Expandable title="properties">
    <ResponseField name="current_page" type="number">
      Número da página atual.
    </ResponseField>

    <ResponseField name="from" type="number">
      Registro inicial da página atual.
    </ResponseField>

    <ResponseField name="last_page" type="number">
      Número da última página disponível.
    </ResponseField>

    <ResponseField name="path" type="string">
      URL base do endpoint da API.
    </ResponseField>

    <ResponseField name="per_page" type="number">
      Número de registros por página.
    </ResponseField>

    <ResponseField name="to" type="number">
      Último registro da página atual.
    </ResponseField>

    <ResponseField name="total" type="number">
      Total de registros encontrados.
    </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.

Além disso, a API conta com outras medidas de segurança para proteger os dados dos usuários.