---
title: "Consultar uso de la API key"
method: GET
path: "/usage"
tags: ["Cuenta"]
---

# Consultar uso de la API key

`GET /usage`

Devuelve el uso actual de la clave (consumo del día, límite, plan, endpoints más usados). No consume cuota diaria. Requiere la cabecera `X-API-Key`. Tiene límite por IP para evitar enumeración de claves.

## Response `200`

Estado de uso de la clave

- UsageResponse
  - `success` boolean
  - `data` object
    - `plan` string
    - `requests_used_today` integer
    - `rate_limit_per_day` integer
    - `remaining_today` integer
    - `is_active` boolean
    - `created_at` string, date-time
    - `last_used_at` string, date-time, nullable
    - `top_endpoints` object[]
      - `endpoint` string
      - `count` integer

## Other responses

- `401` — Clave ausente, con formato inválido, o no encontrada.
- `403` — API key desactivada.
- `429` — Demasiadas peticiones desde tu IP. Reintenta más tarde.
- `500` — Error interno del servidor.

---

[API](https://skmtc.dev/conversoriaecnae/apis/conversor-iae-cnae-api.md) · [All operations](https://skmtc.dev/conversoriaecnae/apis/conversor-iae-cnae-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/conversoriaecnae/conversor-iae-cnae-api/revisions/2f9842f5e11b/schema)