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

> Liste os cursos online ativos da empresa associada ao token.

Retorna os cursos online ativos da empresa, ordenados por nome.

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

## Resposta

O cabeçalho `X-Total-Count` e o campo `totalCount` informam a quantidade de cursos retornados.

```json theme={null}
{
  "courses": [
    {
      "id_company_course": "6c0a9e93-f6d2-4d87-a9ad-df1d1a9f8a01",
      "id_course": "f2e3b0a1-2a7e-4c8d-8b4a-8f0f3e1a2b44",
      "course_name": "Curso de integração",
      "course_description": "Descrição do curso",
      "course_content": "Conteúdo programático",
      "workload_minutes": 120,
      "score_required": 70,
      "objectives": "Objetivos do curso",
      "target_audience": "Colaboradores",
      "methodology": "EAD",
      "category_name": "Onboarding",
      "subcategory_name": "Institucional",
      "card": {
        "name": "card.png",
        "url": "https://cdn.exemplo.com/card.png"
      },
      "is_owner": true,
      "created_at": "2026-08-10T17:30:00.000Z",
      "updated_at": "2026-08-10T17:30:00.000Z"
    }
  ],
  "totalCount": 1
}
```

<ResponseField name="id_company_course" type="string">
  Identificador do vínculo do curso com a empresa.
</ResponseField>

<ResponseField name="id_course" type="string">
  Identificador do curso no catálogo.
</ResponseField>

<ResponseField name="workload_minutes" type="integer">
  Carga horária convertida para minutos.
</ResponseField>

<ResponseField name="is_owner" type="boolean">
  Indica se a empresa associada ao token é proprietária do curso.
</ResponseField>

## Erros

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