> ## 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 temas

> Este endpoint permite listar os temas disponíveis da instituição no Toolzz LMS.

## Parâmetros

<ParamField query="page" type="number">
  Número da página que será retornada (paginação começando em 1).
</ParamField>

<ParamField query="per_page" type="number">
  Quantidade de itens por página (para controle de paginação).
</ParamField>

<ParamField query="search" type="string">
  Pesquisa textual por palavras-chave para filtrar temas por nome ou atributos relacionados.
</ParamField>

## Descrição da Resposta

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

<ResponseField name="data" type="object">
  Resposta principal da API contendo os temas e metadados de paginação.

  <Expandable title="properties">
    <ResponseField name="current_page" type="number">
      Página atual da consulta paginada.
    </ResponseField>

    <ResponseField name="data" type="array">
      Lista de temas retornados.

      <Expandable title="items">
        <ResponseField name="id" type="number">
          ID único do tema.
        </ResponseField>

        <ResponseField name="instituicao_id" type="number">
          ID da instituição associada ao tema.
        </ResponseField>

        <ResponseField name="user_id" type="number">
          ID do usuário criador do tema.
        </ResponseField>

        <ResponseField name="ciclo_id" type="number">
          ID do ciclo educacional associado.
        </ResponseField>

        <ResponseField name="titulo" type="string">
          Título/nome do tema.
        </ResponseField>

        <ResponseField name="tag" type="string">
          Tags associadas ao tema (separadas por vírgula).
        </ResponseField>

        <ResponseField name="created_at" type="string" format="date-time">
          Data de criação do tema.
        </ResponseField>

        <ResponseField name="updated_at" type="string" format="date-time">
          Data da última atualização do tema.
        </ResponseField>

        <ResponseField name="questions" type="array">
          Lista de questões associadas ao tema.

          <Expandable title="items">
            <ResponseField name="id" type="number">
              ID da questão.
            </ResponseField>

            <ResponseField name="tipo" type="number">
              Tipo da questão (1=discursiva, 2=múltipla escolha).
            </ResponseField>

            <ResponseField name="pergunta" type="string">
              Texto da pergunta (pode conter HTML).
            </ResponseField>

            <ResponseField name="tag" type="string">
              Tags associadas à questão.
            </ResponseField>
          </Expandable>
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="first_page_url" type="string">
      URL da primeira página de resultados.
    </ResponseField>

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

    <ResponseField name="per_page" type="number">
      Quantidade de itens por página.
    </ResponseField>

    <ResponseField name="total" type="number">
      Total de itens disponíveis na consulta.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="message" type="string">
  Mensagem descritiva sobre o resultado da operação.
</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.