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

# Dados de Progressão da Instituição

> Recupere os dados atualizados de progressão nos cursos da sua instituição.

<Note>Antes de utilizar este endpoint, certifique-se de possuir o token de autorização.</Note>

## Segurança

Para acessar este endpoint, é necessário enviar um token de acesso válido através do cabeçalho de autorização (Authorization) da requisição. Além disso, a API é protegida por outras medidas de segurança para garantir a proteção dos dados dos usuários.

## Descrição da Resposta

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

<ResponseField name="data" type="object">
  Contém a listagem paginada de usuários com progresso em cursos.

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

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

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

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

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

        <ResponseField name="user_cpf" type="string">
          CPF do usuário (pode estar em branco).
        </ResponseField>

        <ResponseField name="course_name" type="string">
          Nome do curso associado ao progresso.
        </ResponseField>

        <ResponseField name="percentual_usage" type="number">
          Quantidade de conteúdos consumidos.
        </ResponseField>

        <ResponseField name="content_total" type="number">
          Total de conteúdos do curso.
        </ResponseField>

        <ResponseField name="percentual_progress" type="string">
          Progresso percentual do curso (por exemplo, "68%").
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>