Pular para o conteúdo

Lista os alunos de um curso

GET/api/courses/{id}/enrollments

Auth
Exige token
Quem pode:
owner
admin
moderator
SuperAdmin
X-CommunityId
X-CommunityId Envie o X-CommunityId da comunidade em que a operação acontece.

A aba **Alunos**. Só owner, admin e moderador (somente leitura; o SuperAdmin passa como owner). Membro, 403; curso de outra comunidade (`X-CommunityId`), 404. Paginada, **sem busca**, do mais recente para o mais antigo.

**O que entra:** matrículas `enrolled` e `completed` de perfis que ainda existem. A matrícula `cancelled` **não** é listada nem contada. O `pagination.totalCount` é o mesmo número de `stats.enrollments` do `GET /api/courses/{id}`. (O `courses_report` do MCP usa outra janela e não é comparável.)

Cada linha traz a pessoa, a data de matrícula, as aulas concluídas e o total de aulas **que existem hoje**, o percentual, a última atividade e se concluiu.

Parâmetros

NomeOndeTipoDescrição
idobrigatóriopathstring (uuid)
pageopcionalqueryinteger
limitopcionalqueryinteger

Headers

NomeTipoDescrição
X-CommunityIdopcionalstring (uuid)ID da comunidade em que a operação acontece. Obrigatório na maioria dos endpoints com escopo de comunidade.

Respostas

CódigoDescrição
200Página de alunos.
400Requisição inválida — falha de validação.
401Token ausente, inválido ou expirado.
403Autenticado, mas sem permissão para esta operação.
404Recurso não encontrado.
500Erro interno do servidor.

Exemplo com curl

curl -X GET "https://api.memberfy.net/api/courses/<id>/enrollments" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-CommunityId: $COMMUNITY_ID"