---
title: "Your rate-limit window (limit, remaining, reset, in-flight cap) and in-memory usage counters for your API key; anonymous callers see their IP window."
method: GET
path: "/api/v1/key"
tags: ["Agents"]
---

# Your rate-limit window (limit, remaining, reset, in-flight cap) and in-memory usage counters for your API key; anonymous callers see their IP window.

`GET /api/v1/key`

## Request

- Base URL: `https://huggingbay.xyz`
- URL: `https://huggingbay.xyz/api/v1/key`
- Auth: none declared

Your rate-limit window (limit, remaining, reset, in-flight cap) and in-memory usage counters for your API key; anonymous callers see their IP window.

**Inputs.** No path or query fields are required. No request body is required.

**Outputs.** See each status below for its media type, schema and headers. A missing record or unavailable capability is not a successful empty result.

**Errors.** API JSON failures use the documented response schema. Read code, message and next; retry only when the response allows it. Auth, invalid input and missing records need a caller change.

**Rate limits.** Public read budgets apply by client IP and route group. This operation can have a smaller route-specific budget. Read Retry-After on 429 or retryable 503 responses.

## Response `200`

Key usage

- object

## Other responses

- `401`: Invalid API key

## Changes

- **2026-10-26** `554a75e31930`: 1 warning
  - added the new `not-served` enum value to the `status/anyOf[subschema #2]/` response property for the response status `401`
- **2026-10-21** `906c41a6caf3`: 1 breaking, 1 info
  - the `status` response's property type changed from `integer` to no type for status `401`
  - added `subschema #1, subschema #2` to the `status` response property `anyOf` list for the response status `401`
- **2026-10-20** `ea7ba26b1e27`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/huggingbay/apis/hugging-bay-public-api/changes/api/v1/key/get.md)

---

[API](https://skmtc.dev/huggingbay/apis/hugging-bay-public-api.md) - [All operations](https://skmtc.dev/huggingbay/apis/hugging-bay-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/huggingbay/apis/hugging-bay-public-api/revisions/c5016474b723?raw)