Lista as assinaturas da comunidade (gestão pela equipe)

GET/api/manage/subscriptions

Auth: Requiere token
Quién puede:: owner; admin; finance
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-45. Exige owner, admin ou finance da comunidade do `X-CommunityId`. Mais novas primeiro. Cada item: `member` (nome, e-mail), `plan` e `product` (opção), `status` e `statusLabel` (`CANCELING` quando vai encerrar no fim do período), `source` (`CHECKOUT` ou `MANUAL`), `isComplimentary` e `complimentaryUntil`, valor (`billingAmount`, `regularAmount`, `discountPercent`, `discountEndsAt`), `addOns` cobrados junto, `nextChargeTotal`, `paymentMethod`, `pendingRenewal` (PIX/boleto em aberto), `commitmentEndsAt`, `nextBillingDate` e o período. Adicionais cobrados com o plano não aparecem como item próprio. Nunca traz custo de provedor.

Parámetros

Nombre	Dónde	Tipo	Descripción
`status`opcional	query	`ACTIVE \| TRIALING \| PAST_DUE \| PAUSED \| CANCELING \| CANCELED \| EXPIRED \| COMPLIMENTARY`
`productId`opcional	query	`string (uuid)`	Opção de cobrança
`subscriptionGroupId`opcional	query	`string (uuid)`	Plano
`from`opcional	query	`string (date-time)`	Início da assinatura a partir de
`to`opcional	query	`string (date-time)`	Início da assinatura até
`search`opcional	query	`string`	Nome ou e-mail do membro
`page`opcional	query	`integer`
`limit`opcional	query	`integer`

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`	Lista paginada.
`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/manage/subscriptions" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-CommunityId: $COMMUNITY_ID"