---
title: "Get Key Usage Info"
method: GET
path: "/api/v1/keys/ephemeral/info"
tags: ["API Keys"]
---

# Get Key Usage Info

`GET /api/v1/keys/ephemeral/info`

## Request

- Base URL: `https://api.bellatorsi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.bellatorsi.com/api/v1/keys/ephemeral/info`
- Auth: none declared. Required headers: `X-API-Key`

Get usage information for current ephemeral key.

**Authentication Required:** Include ephemeral key in `X-API-Key` header.

Returns:
- Usage count and remaining calls
- Time until expiry
- Key validity status

**Use Cases:**
- Display usage meter in playground UI
- Warn users when approaching limits
- Trigger upgrade prompts

## Headers

- `X-API-Key` string, required

## Response `200`

Key information retrieved

- KeyUsageInfoResponse: Response model for key usage information.
  - `usage_count` integer, required: Number of API calls made
  - `usage_limit` integer, required: Maximum number of API calls allowed
  - `usage_remaining` integer, required: Remaining API calls
  - `ttl_seconds` integer, required: Seconds until key expires
  - `expires_at` string, required: ISO 8601 expiry timestamp
  - `created_at` string: ISO 8601 creation timestamp
  - `type` string: Key type

## Other responses

- `404`: Key not found or expired
- `422`: Validation Error

---

[API](https://skmtc.dev/bellatorsi/apis/bellator-schedule-intelligence-apis.md) · [All operations](https://skmtc.dev/bellatorsi/apis/bellator-schedule-intelligence-apis/llms.txt) · [OpenAPI document](https://skmtc.dev/bellatorsi/apis/bellator-schedule-intelligence-apis/revisions/03e7b786e43b?raw)