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

> Liste cursos e trilhas configurados como destaques internos da empresa.

Retorna cursos e trilhas em destaque na vitrine interna da empresa. Itens inexistentes e cursos que não estão ativos são removidos do resultado.

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

## Resposta

```json theme={null}
{
  "coursesList": [
    {
      "id": "0b114044-1ab8-48f9-aad5-8e38dd423c91",
      "index": "1",
      "type": "course",
      "id_company_course": "6c0a9e93-f6d2-4d87-a9ad-df1d1a9f8a01",
      "id_course": "f2e3b0a1-2a7e-4c8d-8b4a-8f0f3e1a2b44",
      "id_trail": null,
      "name": "Curso de integração",
      "description": "Descrição do curso",
      "content": "Conteúdo programático",
      "workload_minutes": 120,
      "score_required": 70,
      "category_name": "Onboarding",
      "subcategory_name": "Institucional",
      "card": {
        "name": "card.png",
        "url": "https://cdn.exemplo.com/card.png"
      },
      "is_owner": true
    },
    {
      "id": "2c41040c-d3d4-4d88-b23c-f1c447ea5dd4",
      "index": "2",
      "type": "trail",
      "id_company_course": null,
      "id_course": null,
      "id_trail": "4b9fa8c5-cb9d-42d5-9d69-872312d0b2c1",
      "name": "Trilha de onboarding",
      "description": "Cursos iniciais para novos colaboradores",
      "content": null,
      "workload_minutes": null,
      "card": {
        "name": "trail-cover.png",
        "url": "https://cdn.exemplo.com/trail-cover.png"
      },
      "is_owner": null
    }
  ],
  "hasFeaturedCourse": true,
  "totalCount": 2
}
```

<ResponseField name="type" type="string">
  Retorna `course` para curso ou `trail` para trilha.
</ResponseField>

<ResponseField name="hasFeaturedCourse" type="boolean">
  Indica se existe alguma configuração de destaque, mesmo que um item inválido tenha sido removido de `coursesList`.
</ResponseField>

O cabeçalho `X-Total-Count` repete a quantidade de itens publicados em `totalCount`.

## Erros

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