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

# Listar trilhas de um usuário

> Consulte as trilhas associadas a um usuário da empresa.

Retorna as trilhas vinculadas ao usuário informado. A API confirma que o usuário pertence à empresa associada ao token antes de executar a consulta.

<ParamField path="id_user" type="string" required>
  UUID do usuário.
</ParamField>

```bash cURL theme={null}
curl https://api.crescamais.com/integrations/analytics/trail-user/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer SEU_TOKEN_DE_INTEGRACAO"
```

## Resposta

O corpo é um array. O cabeçalho `X-Total-Count` informa a quantidade de itens.

```json theme={null}
[
  {
    "id": "4b9fa8c5-cb9d-42d5-9d69-872312d0b2c1",
    "banner": "https://bucket.s3.amazonaws.com/trilha.png",
    "name": "Trilha de onboarding",
    "description": "Cursos iniciais para novos colaboradores",
    "required_trail": true,
    "id_file": "9d8bb4bf-50ba-4c56-9555-7b39ad7d40b7",
    "file_name": "trilha.png",
    "id_course": "f2e3b0a1-2a7e-4c8d-8b4a-8f0f3e1a2b44",
    "progress": "50.00",
    "quantity_courses": "4",
    "quantity_question": "10",
    "workload": "8"
  }
]
```

<ResponseField name="id_course" type="string | null">
  Próximo curso ainda não concluído na ordem da trilha. Pode ser `null` quando não houver um próximo curso.
</ResponseField>

<ResponseField name="progress" type="string">
  Percentual de cursos concluídos, sem o símbolo `%`.
</ResponseField>

<ResponseField name="quantity_question" type="string">
  Quantidade de conteúdos do tipo questão nos cursos da trilha.
</ResponseField>

## Erros

| Status | Causa                                               |
| ------ | --------------------------------------------------- |
| `401`  | Token ausente, malformado ou inválido.              |
| `404`  | O usuário não existe na empresa associada ao token. |
| `400`  | Erro ao consultar as trilhas do usuário.            |