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

# Consultar relatório acadêmico

> Consulte matrículas, progresso, nota e situação acadêmica dos alunos.

Retorna as matrículas em cursos online da empresa associada ao token. Cada registro combina dados do aluno, do curso e do progresso.

```bash cURL theme={null}
curl https://api.crescamais.com/integrations/analytics/academic \
  -H "Authorization: Bearer SEU_TOKEN_DE_INTEGRACAO"
```

## Resposta

```json theme={null}
{
  "academic": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "id_course": "f2e3b0a1-2a7e-4c8d-8b4a-8f0f3e1a2b44",
      "course_name": "Curso de integração",
      "category": "Onboarding",
      "workload": "2",
      "score_course": 70,
      "matrícula_criada": "10/08/2026 09:30",
      "finalização": "Em andamento",
      "student_name": "João da Silva",
      "student_cpf": "18498670039",
      "student_email": "joao@empresa.com",
      "last_login": "02/09/2026 10:45",
      "created_at": "01/08/2026 09:00",
      "status": 1,
      "status_user": "Ativo",
      "teams": "Marketing- Novos colaboradores",
      "trail_name": "Trilha de onboarding",
      "lessons_count": "10",
      "finished_lessons_count": "5",
      "progresso": "50.00%",
      "nota": "n/a",
      "approved": "Em andamento",
      "Setor": "Marketing"
    }
  ],
  "totalCount": 1
}
```

O cabeçalho `X-Total-Count` repete a quantidade informada em `totalCount`.

## Campos calculados

| Campo         | Descrição                                                          |
| ------------- | ------------------------------------------------------------------ |
| `progresso`   | Percentual de aulas concluídas, formatado com `%`.                 |
| `nota`        | Nota da avaliação multiplicada por 100 ou `n/a` quando não existe. |
| `approved`    | `Não iniciado`, `Em andamento`, `Aprovado` ou `Não aprovado`.      |
| `status_user` | `Ativo` quando `status` é `1`; caso contrário, `Bloqueado`.        |
| `finalização` | Data no formato `DD/MM/AAAA HH:mm` ou `Em andamento`.              |

Os campos personalizados da empresa são adicionados diretamente a cada registro. Os nomes e tipos desses campos variam entre empresas.

<Note>
  A resposta atual não possui paginação efetiva. Planeje o consumo considerando que todos os registros compatíveis podem ser retornados na mesma chamada.
</Note>

## Erros

| Status | Causa                                  |
| ------ | -------------------------------------- |
| `401`  | Token ausente, malformado ou inválido. |
| `500`  | Erro interno durante a consulta.       |