Assinaturas Perdidas
Acompanhe cancelamentos e assinaturas inativas para identificar padrões de perda, medir o impacto financeiro e tomar decisões que melhorem a retenção.
Escopo
O que é este endpoint?
Lista todas as assinaturas canceladas ou inativas do seu negócio. A resposta inclui métricas agregadas com o valor financeiro em risco e a quantidade de clientes afetados.Casos de uso
Avaliar a retenção de clientes
Avaliar a retenção de clientes
Detectar picos de cancelamento
Detectar picos de cancelamento
Medir o impacto de reajustes de preço
Medir o impacto de reajustes de preço
Comparar desempenho entre períodos
Comparar desempenho entre períodos
Acompanhar a saúde da receita
Acompanhar a saúde da receita
total_at_risk_value mostra o valor total das assinaturas canceladas e inativas. Isso ajuda a dimensionar o problema em dinheiro.Descobrir sinais de insatisfação
Descobrir sinais de insatisfação
Insights que podem ser obtidos
Identificar problemas de retenção
Identificar problemas de retenção
Avaliar mudanças no negócio
Avaliar mudanças no negócio
Antecipar quedas na receita
Antecipar quedas na receita
Planejar campanhas de recuperação
Planejar campanhas de recuperação
Filtros Disponíveis
Filtros por Status
Filtros por Status
status— Status da assinatura (canceled,inactive, ou ambos separados por vírgula)
?status=canceled,inactive — Traz tanto canceladas quanto inativasFiltros por Período
Filtros por Período
current_period— Período atual da assinatura (número inteiro)current_period__gt— Período maior quecurrent_period__lt— Período menor que
?current_period__gt=3 — Assinaturas que já passaram do 3º períodoFiltros por Data
Filtros por Data
createdAt— Data de criação (suporta__gte,__lte,__gt,__lt)canceledAt— Data de cancelamento (suporta__gte,__lte,__gt,__lt)next_payment_date— Próximo pagamento (suporta__gte,__lte,__gt,__lt)
YYYY-MM-DD ou ISO 8601 YYYY-MM-DDTHH:MM:SS±hh:mm?canceledAt__gte=2025-01-01&canceledAt__lt=2025-02-01 — Cancelamentos de janeiro de 2025Paginação
Paginação
limit— Número de resultados por página (padrão: 100)offset— Índice do primeiro resultado
?limit=50&offset=50 — Página 2 com 50 resultados por páginaMétricas Retornadas
A resposta inclui um objetometrics com as seguintes informações financeiras e quantitativas:
name é retornado no objeto customer.Authorizations
Token de autenticação do tipo Bearer {access_token}, onde {access_token} é o token obtido no fluxo de autenticação.
Query Parameters
Número de resultados a serem retornados por página.
Índice do primeiro resultado a ser retornado.
Filtra por status da assinatura (canceled, inactive, ou ambos separados por vírgula)
Filtra pelo período atual da assinatura
Filtra por período maior que
Filtra por período menor que
Filtra por data de criação maior ou igual (formato ISO 8601)
Filtra por data de criação menor ou igual (formato ISO 8601)
Filtra por data de cancelamento maior ou igual (formato ISO 8601)
Filtra por data de cancelamento menor ou igual (formato ISO 8601)