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

# Submissões

> Endpoints para gerenciar respostas e resultados de testes.

## GET /api/submissions

Lista submissões do usuário autenticado (ou todas, para admins).

### Query Params

| Param         | Tipo    | Descrição              |
| ------------- | ------- | ---------------------- |
| `page`        | number  | Página                 |
| `limit`       | number  | Itens por página       |
| `formId`      | string  | Filtrar por formulário |
| `studentId`   | string  | Filtrar por aluno      |
| `isCompleted` | boolean | Apenas concluídas      |

### Resposta

```json theme={null}
{
  "submissions": [
    {
      "id": "sub_id",
      "formId": "form_id",
      "studentId": "student_id",
      "totalScore": 75,
      "maxScore": 100,
      "isCompleted": true,
      "createdAt": "2026-02-01T10:00:00.000Z",
      "form": { "title": "Avaliação Funcional" },
      "student": { "name": "Ana Lima" }
    }
  ],
  "total": 120
}
```

***

## GET /api/submissions/:id

Retorna uma submissão completa com todas as respostas.

```json theme={null}
{
  "id": "sub_id",
  "totalScore": 75,
  "maxScore": 100,
  "isCompleted": true,
  "answers": [
    {
      "questionId": "q_id",
      "questionText": "A criança consegue...",
      "selectedOptionId": "opt_id",
      "selectedOptionText": "Sim, com autonomia",
      "points": 3
    }
  ]
}
```

***

## POST /api/reports/export

Gera e retorna o PDF do relatório de uma submissão.

**Autenticação:** Obrigatória

### Body (JSON)

```json theme={null}
{
  "submissionId": "sub_id"
}
```

### Resposta

`Content-Type: application/pdf` — retorna o arquivo PDF diretamente.