---
title: "Get API usage statistics"
method: GET
path: "/v1/usage"
tags: ["core"]
---

# Get API usage statistics

`GET /v1/usage`

Get current usage, quota, and reset date for the API key.

## Headers

- `X-API-Key` string, nullable

## Response `200`

Successful Response

- UsageResponse — Response model for usage endpoint.
  - `tier` string, required — API key tier (free, paid, enterprise)
  - `api_key_id` string, required — API key ID
  - `customer_name` string, required — Customer name
  - `quota_limit` integer, required — Maximum requests allowed per period
  - `current_usage` integer, required — Current usage count
  - `remaining` integer, required — Remaining requests
  - `available` integer, nullable — Credits spendable right now - same value as `remaining`, named for the question callers ask. Already net of credits frozen by in-flight reservations.
  - `call_credit_hold` integer, nullable — Credits ONE outbound call freezes at dial time (a refundable hold, not a charge). available // call_credit_hold is the CREDIT-limited bound on calls in flight - entitlement and the per-customer concurrency cap gate independently, so it is not a guarantee that many will start.
  - `percentage_used` number, required — Percentage of quota used
  - `reset_date` string, required — Date when usage resets (YYYY-MM-DD)
  - `period` string, required — Quota period (monthly, weekly, daily)
  - `status` string, required — API key status (active, revoked, suspended)
  - `validation_timestamp` string, nullable — UTC timestamp when usage response was produced (ISO 8601).

## Other responses

- `401` — Missing API key header
- `403` — Invalid, revoked, or unauthorized API key
- `422` — Validation Error

---

[API](https://skmtc.dev/voygr/apis/voygr-calls-api.md) · [All operations](https://skmtc.dev/voygr/apis/voygr-calls-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/voygr/voygr-calls-api/revisions/a505c0ec5698/schema)