---
title: "GET /v1/usage"
description: "Uso e franquia da conta"
canonical: "https://cnpj.ia.br/docs/referencia/get-usage"
date_modified: 2026-09-02
source: "cnpj.ia.br"
---

docs · base agosto/2026 Atualizado em 02/09/2026

# GET /v1/usage

Uso e franquia da conta

## Créditos

chamada · **0** créditos

## Respostas

### 200 OK

Uso do ciclo corrente.

### 401 Não autorizado

Chave ausente, desconhecida, revogada ou expirada.

## Ferramenta MCP

No servidor MCP oficial esta operação é a ferramenta `ver_uso`, com a mesma chave e os mesmos créditos da API.

## Exemplo

```bash
curl -s "https://api.cnpj.ia.br/v1/usage" \
  -H "Authorization: Bearer $CNPJIA_KEY"
```