# Métricas: visão geral

Rotas de analytics para integração: resumos e séries de assinaturas e cobranças.

> **Disponível apenas em produção.** As rotas de métricas não existem no sandbox. Use credenciais de produção e a URL `https://api.validapay.com.br`.

## Autenticação

Token de `POST /auth/token` (`grant_type=client_credentials`).

| Rotas | Scopes |
|---|---|
| Resumo e séries de assinaturas (`/subscriptions/summary`, `/mrr`, `/mrr/by-payment-method/series`, `/mrr/delinquency`, `/churn`) | `subscriptions/read` |
| Resumo de cobranças (`/charges/summary`) | `charges/read` ou `pix.cob/read` |

## Rotas

| Método | Path | Função |
|---|---|---|
| GET | `/v1/analytics/subscriptions/summary` | Cards de assinaturas: MRR, churn, inadimplência, breakdowns |
| GET | `/v1/analytics/charges/summary` | Cards de cobranças por período (`dateBasis`) |
| GET | `/v1/analytics/mrr` | Série temporal de MRR ACTIVE e assinantes. O empilhado recorrente × novo está na página [MRR](/referencia/get-mrr#mrr-novo-x-recorrente) |
| GET | `/v1/analytics/mrr/by-payment-method/series` | Série de MRR empilhada por método de pagamento |
| GET | `/v1/analytics/mrr/delinquency` | Série de estoque de MRR inadimplente |
| GET | `/v1/analytics/churn` | Série de perda de MRR (eventos de churn) |

## Regras rápidas

- Valores monetários em reais, string decimal (`"12345.67"`).
- Em summaries, `startDate` e `endDate` devem vir juntos; apenas um → `400 INVALID_DATE_RANGE`.
- Em `/charges/summary`, `dateBasis` é `created` (default), `paid` ou `created_and_paid`.
- `/mrr` é estoque ACTIVE; `/churn` é evento de perda; `/mrr/delinquency` é estoque overdue. Não misture as três leituras.