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

> Liste as trilhas da empresa e os cursos online ativos contidos em cada uma.

Retorna as trilhas da empresa. Cada trilha inclui seus cursos online ativos, ordenados pela posição definida na trilha.

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

## Resposta

```json theme={null}
{
  "trails": [
    {
      "id_trail": "4b9fa8c5-cb9d-42d5-9d69-872312d0b2c1",
      "trail_name": "Trilha de onboarding",
      "trail_description": "Cursos iniciais para novos colaboradores",
      "sequential_course": true,
      "completion_days": 30,
      "signable": true,
      "visible": true,
      "required": false,
      "cover": {
        "name": "trail-cover.png",
        "url": "https://cdn.exemplo.com/trail-cover.png"
      },
      "courses": [
        {
          "id_trail_course": "8b74aaf7-67bb-4e54-b57a-76e0cb9b6d9e",
          "trail_course_order": 1,
          "id_company_course": "6c0a9e93-f6d2-4d87-a9ad-df1d1a9f8a01",
          "id_course": "f2e3b0a1-2a7e-4c8d-8b4a-8f0f3e1a2b44",
          "course_name": "Curso de integração",
          "workload_minutes": 120,
          "score_required": 70,
          "category_name": "Onboarding",
          "subcategory_name": "Institucional",
          "card": null,
          "is_owner": true
        }
      ],
      "courses_count": 1,
      "created_at": "2026-08-10T17:30:00.000Z",
      "updated_at": "2026-08-10T17:30:00.000Z"
    }
  ],
  "totalCount": 1
}
```

Os objetos de `courses` também podem incluir `course_description`, `course_content`, `objectives`, `target_audience`, `methodology`, `created_at` e `updated_at`.

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

## Erros

| Status | Causa                                     |
| ------ | ----------------------------------------- |
| `401`  | Token ausente, malformado ou inválido.    |
| `400`  | Erro ao consultar ou formatar as trilhas. |