---
title: Usage & Analytics API
description: Reference and interactive runner for usage & analytics operations.
---

<KeyInserter type="api" label="API Key Tester" placeholder="zrv_your_api_key" />

## Get API Key Usage Summary

Inspect live period spend, spending caps, and remaining balance using an API key directly.

<Callout type="tip" title="Public CORS Support">
  This endpoint has public CORS enabled and can be queried directly by browser clients and frontend extensions.
</Callout>
--

<ApiEndpoint method="GET" path="/inference-keys/usage" auth="api_key" />

### Headers

| Header | Value | Required | Description |
| :--- | :--- | :--- | :--- |
| `Authorization` | `Bearer <zrv_api_key>` | **Yes** | Your active Zorveus API key. |

<ApiRunner method="GET" path="/inference-keys/usage" authType="api_key" />

#### Response (`200 OK`) — Capped Connection

```json
{
  "status": "active",
  "app_id": "app_mindspire_123",
  "app_connection_id": "appcon_01j...",
  "currency": "USD",
  "period": "monthly",
  "spend_cap": "50.000000000000",
  "spent_this_period": "12.500000000000",
  "remaining_balance": "37.500000000000",
  "reset_at": "2026-09-01T00:00:00Z"
}
```

#### Response (`200 OK`) — Uncapped Connection

```json
{
  "status": "active",
  "app_id": "app_mindspire_123",
  "app_connection_id": "appcon_01j...",
  "currency": "USD",
  "period": "monthly",
  "spend_cap": null,
  "spent_this_period": "12.500000000000",
  "remaining_balance": null,
  "reset_at": null
}
```