---
title: "Dados da chave e da empresa"
method: GET
path: "/v1/me"
tags: ["Conta"]
---

# Dados da chave e da empresa

`GET /v1/me`

## Request

- Base URL: `https://api.notaguard.com.br`
- URL: `https://api.notaguard.com.br/v1/me`
- Auth: HTTP bearer

Valida a chave e devolve a empresa que ela abre, os escopos concedidos e o limite restante na janela atual. Use como primeira chamada de qualquer integração.

## Response `200`

Chave válida.

- Me
  - `empresa` object, required
    - `id` string, required: Identificador da empresa no NotaGuard.
    - `nome` string, required
    - `documento` string, nullable, required: CNPJ ou CPF da empresa.
  - `chave` object, required
    - `id` string, uuid, required
    - `nome` string, required: Nome dado à chave no painel.
    - `prefixo` string, required: Primeiros caracteres do token, para você identificar de qual chave se trata. O token completo nunca é devolvido.
    - `escopos` string[], required
    - `criada_em` string, date-time, required
    - `expira_em` string, date-time, nullable, required: `null` quando a chave não tem prazo de expiração.
  - `plano` object, required
    - `tier` string, required: Plano vigente da empresa (por exemplo `professional`).
    - `api_liberada` true, required: Sempre `true` aqui: se o plano não liberasse a API, a requisição teria falhado com `recurso_nao_disponivel_no_plano`.
  - `limites` object, required
    - `requisicoes_por_minuto` integer, required: Custo total permitido por minuto para esta chave.
    - `restante_no_minuto` integer, required: Quanto ainda pode ser consumido na janela atual.
    - `reinicia_em` string, date-time, required: Quando a janela atual zera (ISO 8601, UTC).

## Other responses

- `400`: Parâmetro inválido ou cursor corrompido.
- `401`: Chave ausente, inválida, revogada ou expirada.
- `403`: Escopo insuficiente ou plano sem acesso via API.
- `429`: Limite de requisições excedido.
- `500`: Erro interno.

---

[API](https://skmtc.dev/notaguard/apis/api-notaguard.md) · [All operations](https://skmtc.dev/notaguard/apis/api-notaguard/llms.txt) · [OpenAPI document](https://skmtc.dev/notaguard/apis/api-notaguard/revisions/118f819f30d6?raw)