---
title: "Estatísticas de Uso"
method: GET
path: "/usage/stats"
tags: ["Estatísticas de Uso"]
---

# Estatísticas de Uso

`GET /usage/stats`

Retorna estatísticas de uso agregadas por dia, semana ou mês, de acordo com a solicitação do usuário. As métricas disponíveis são valor gasto ou quantidade de requests do usuário.

**Métricas disponíveis:**
- `spent`: Valor total gasto pelo usuário (em BRL - Reais)
- `requests`: Quantidade de requests realizados pelo usuário
- `all`: Ambas as métricas (spent e requests) em uma única resposta

**Períodos de agregação:**
- `day`: Agregação diária
- `week`: Agregação semanal
- `month`: Agregação mensal

**Valores padrão:**
- `metric_type`: requests
- `aggregation_period`: day
- `lookback_periods`: 15

**Limitações:**
- Máximo de 1000 períodos para lookback
- Breakdown disponível apenas para métrica `requests`
- Use `lookback_periods` OU `start_date`/`end_date`, não ambos

## Query parameters

- `metric_type` 'spent' | 'requests' | 'all'
- `aggregation_period` 'day' | 'week' | 'month'
- `lookback_periods` string
- `start_date` string, date
- `end_date` string, date
- `breakdown` string

## Response `200`

Sucesso

- object
  - `data` object
    - `metric_type` string
    - `aggregation_period` string
    - `lookback_periods` number, nullable
    - `start_date` string, nullable
    - `end_date` string, nullable
    - `breakdown` boolean
    - `stats` object[]
      - `period` string
      - `value` number — Valor da métrica. Para `spent`, o valor é retornado em BRL (Reais). Para `requests`, o valor é a quantidade de requests.
      - `breakdown` object, nullable
    - `spent_stats` object[], nullable
      - `period` string
      - `value` number — Valor gasto em BRL (Reais).
      - `breakdown` object, nullable
    - `requests_stats` object[], nullable
      - `period` string
      - `value` number — Quantidade de requests.
      - `breakdown` object, nullable

## Other responses

- `400` — Erro de validação

---

[API](https://skmtc.net/registrorural/apis/api-registro-rural-v2-0.md) · [All operations](https://skmtc.net/registrorural/apis/api-registro-rural-v2-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/registrorural/api-registro-rural-v2-0/versions/7b47a5c8532c/schema)