# Inadimplência

**Área:** Séries temporais

Série temporal da carteira de assinaturas vencidas e não pagas (status `DEFAULT` e `PAST_DUE`). Explica quedas de MRR sem evento de churn. Esta série temporal considera assinaturas com pelo menos um ciclo em atraso. Se a assinatura estiver no primeiro ciclo e este ciclo estiver em atraso, então a assinatura está vencida com status `PAST_DUE`. Por outro lado, se esta assinatura já teve pelo menos um ciclo pago, então a assinatura está em inadimplência com status `DEFAULT`.

`GET /v1/analytics/mrr/delinquency`

**Base URL Produção:** `https://api.validapay.com.br`

> Disponível apenas em produção. Esta rota não existe no sandbox: use credenciais e a URL de produção.

## Simulação de consumo de rotas

A página HTML traz o gráfico interativo com as séries MRR, Churn, MRRM, Inadimplência e Assinantes e os filtros Semanal, Mensal, Semestral, Anual e Personalizado.
Os dados vêm das rotas públicas `GET /v1/analytics/demo/...` em `https://api.validapay.com.br`, sem token.
Assinantes usa `activeSubscriptions` de `GET /v1/analytics/demo/mrr`.


**Scopes necessários:** `subscriptions/read`

Valores monetários vêm como string decimal em reais (ex.: `"12345.67"`).

- `granularity=day` (default): estoque + `inflowMrr` dia a dia.
- `granularity=month`: estoque do último dia disponível do mês; `inflowMrr` = soma dos inflows diários.
- Dias sem inadimplentes (ou sem cobertura) **não** geram linha.

Case de uso:

_Como integrador, quero correlacionar queda de MRR com entrada em inadimplência, sem misturar com churn._

### Query parameters

| Campo | Obrigatório | Descrição |
|---|---|---|
| `granularity` | não | day (default) ou month |
| `startDate` | não | Início diário YYYY-MM-DD |
| `endDate` | não | Fim diário YYYY-MM-DD |
| `startMonth` | não | Início mensal YYYY-MM |
| `endMonth` | não | Fim mensal YYYY-MM |

### Resposta 200: 200

```json
{
  "accountId": "460851686",
  "granularity": "day",
  "startDate": "2026-09-01",
  "endDate": "2026-09-12",
  "items": [
    {
      "period": "2026-09-06",
      "delinquentMrr": "648.00",
      "defaultMrr": "648.00",
      "pastDueMrr": "0.00",
      "inflowMrr": "0.00",
      "subscriptionCount": 3,
      "defaultCount": 3,
      "pastDueCount": 0,
      "currency": "BRL"
    },
    {
      "period": "2026-09-07",
      "delinquentMrr": "7129.35",
      "defaultMrr": "6481.35",
      "pastDueMrr": "648.00",
      "inflowMrr": "6481.35",
      "subscriptionCount": 24,
      "defaultCount": 23,
      "pastDueCount": 1,
      "currency": "BRL"
    }
  ]
}
```


### Resposta 400: 400 Intervalo de datas inválido

```json
{
  "error": {
    "message": "startDate e endDate devem ser informados juntos",
    "code": "INVALID_DATE_RANGE",
    "details": null,
    "timestamp": "2026-10-10T18:00:00.000Z"
  }
}
```


---

Página: https://docs.validapay.com.br/referencia/get-inadimplencia  
Contrato OpenAPI: https://docs.validapay.com.br/openapi.json