---
title: "Obter uso atual da conta autenticada"
method: GET
path: "/api/v2/user/usage"
tags: ["Conta"]
---

# Obter uso atual da conta autenticada

`GET /api/v2/user/usage`

Retorna o uso atual da conta autenticada usando a mesma contagem cacheada do limitador de uso.

### O que retorna

* `planName` — plano atual da conta (`free`, `startup`, `pro`)
* `planLimit` — limite de requisições do plano
* `currentUsage` — uso atual contabilizado no banco
* `remainingUsage` — saldo restante dentro da janela atual
* `usageWindow` — janela usada para contagem (`billing-cycle` ou `rolling-30d`)
* `subscriptionPeriod` — período atual de assinatura salvo no usuário

### Autenticação

Bearer token ou query param `token`.

### Exemplo

```bash
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/user/usage"
```

## Response `200`

Uso da conta retornado com sucesso.

- UserUsageResponse
  - `usage` UserUsageData, required
    - `planName` 'free' | 'startup' | 'pro', required
    - `planLimit` integer, required
    - `currentUsage` integer, required
    - `remainingUsage` integer, required
    - `usageWindow` UserUsageWindow, required
      - `type` 'billing-cycle' | 'rolling-30d', required
      - `start` string, date-time, required
      - `end` string, date-time, required
    - `subscriptionPeriod` UserSubscriptionPeriod, required
      - `start` string, date-time, nullable, required
      - `end` string, date-time, nullable, required
  - `requestedAt` string, date-time, required — Data e hora da requisição em formato ISO 8601
  - `took` integer, required — Tempo de processamento em milissegundos

## Other responses

- `401` — Token ausente, inválido ou inativo.
- `404` — Usuário associado ao token não encontrado.
- `500` — Erro interno ao buscar o uso da conta.

---

[API](https://skmtc.net/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro.md) · [All operations](https://skmtc.net/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/brapi-dev/brapi-api-do-mercado-financeiro-brasileiro/revisions/f275d46193ea/schema)