Relatório de membros (novos, ativos, inativos, por grupo e tag)

GET/api/reports/members

Auth: Requiere token
Quién puede:: owner; admin; moderator
X-CommunityId: X-CommunityId Envía el X-CommunityId de la comunidad en la que ocurre la operación.

Las descripciones de los endpoints vienen de la especificación de la API y, por ahora, están en portugués. La interfaz alrededor está traducida.

F-46. Owner, admin ou moderador.

**Ativo** é quem fez pelo menos uma destas coisas no período: publicou (post ou conteúdo), comentou, reagiu, se inscreveu em evento (vou/talvez), se matriculou em curso, abriu ou concluiu aula, ou ganhou pontos no ranking (inclui o login diário, quando a gamificação está ligada). Só ler, sem interagir, não conta: visualizações não são registradas. No retrato atual (`current`), ativo é quem fez isso nos últimos 30 dias ou entrou no app nesse intervalo (`lastSeenAt`).

`series[]`: `new` (entraram no período), `active`, `total` (membros no fim do período) e `inactive` (`total` − `active`). `byGroup[]` e `byTag[]` (até 100 tags) trazem `total`, `new`, `active` e `inactive` na janela. Membros removidos não contam.

Parámetros

Nombre	Dónde	Tipo	Descripción
`interval`opcional	query	`day \| week \| month`	Tamanho de cada período da série. `week` começa na segunda-feira. Rótulo do período: `YYYY-MM-DD` (dia ou segunda-feira da semana) ou `YYYY-MM` (mês). Máximo de períodos por consulta: 366 dias, 156 semanas ou 120 meses.
`from`opcional	query	`string (date)`	Primeiro dia (inclusive), no fuso do relatório, alargado para o início do período (com `interval=month`, `2026-03-15` vira `2026-03-01`). Padrão: 30 dias, 12 semanas ou 12 meses antes de `to`.
`to`opcional	query	`string (date)`	Último dia (inclusive), alargado até o fim do período. Padrão hoje.
`timezone`opcional	query	`string`	Fuso IANA em que os períodos são contados. Padrão: o fuso do país da comunidade (o mesmo dos prazos do call4papers). A resposta devolve o fuso usado em `timezone`.

Headers

Nombre	Tipo	Descripción
`X-CommunityId`opcional	`string (uuid)`	ID da comunidade em que a operação acontece. Obrigatório na maioria dos endpoints com escopo de comunidade.

Respuestas

Código	Descripción
`200`	Série pronta para gráfico.
`400`	Requisição inválida — falha de validação.
`401`	Token ausente, inválido ou expirado.
`403`	Autenticado, mas sem permissão para esta operação.
`500`	Erro interno do servidor.

Ejemplo con curl

curl -X GET "https://api.memberfy.net/api/reports/members" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-CommunityId: $COMMUNITY_ID"