---
title: "Your metered usage"
method: GET
path: "/v1/usage"
tags: ["Usage"]
---

# Your metered usage

`GET /v1/usage`

Durable usage totals (requests, input characters, audio seconds) for the calling API key. Without parameters, lifetime totals. With `start_time`/`end_time` (ISO 8601), totals for that window at hourly granularity: the effective window snaps outward to hour boundaries and is echoed back in the response.

## Query parameters

- `start_time` string, date-time, nullable — Window start (ISO 8601; naive = UTC). Snapped down to the hour. Omit both bounds for lifetime totals.
- `end_time` string, date-time, nullable — Window end (ISO 8601, exclusive; naive = UTC). Snapped up to the hour. Defaults to now when only start_time is given.

## Response `200`

Successful Response

- UsageSummaryResponse — Durable usage totals for the calling key — lifetime by default, or an hour-granular window when ``start_time``/``end_time`` were passed (the echoed values are the effective, hour-snapped bounds actually summed).
  - `key_id` string, required — Non-secret identifier of the API key whose usage is summarized.
  - `requests` integer, required
  - `input_chars` integer, required
  - `input_audio_seconds` number, required
  - `output_audio_seconds` number, required
  - `first_request_ts` number, nullable — Unix time of the first metered request (lifetime queries).
  - `last_request_ts` number, nullable — Unix time of the latest metered request (lifetime queries).
  - `start_time` string, date-time, nullable — Effective (hour-snapped) window start; windowed queries only.
  - `end_time` string, date-time, nullable — Effective (hour-snapped) window end, exclusive; windowed queries only.

## Other responses

- `400` — Semantically invalid request.
- `401` — Missing or invalid API key.
- `422` — Validation Error
- `500` — Unexpected internal error.
- `503` — Key verification or usage reporting is temporarily unavailable.

---

[API](https://skmtc.net/kalpalabs/apis/kalpa-speech-api.md) · [All operations](https://skmtc.net/kalpalabs/apis/kalpa-speech-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kalpalabs/kalpa-speech-api/versions/60add3abf640/schema)