---
title: "Check API key usage"
method: GET
path: "/v1/keys/usage"
tags: ["API Keys"]
---

# Check API key usage

`GET /v1/keys/usage`

Returns current month usage and remaining quota for the provided API key. `basis` says which ceiling actually governs the key: "monthly" for a free or subscription key, "credits" for a prepaid bundle. On a bundle key, `used` counts the calls billed this month for information only — nothing is enforced against `limit`/`remaining`, and the balance that can turn a call away is served alongside as `credits_remaining` / `credits_total`.

## Response `200`

Usage for the current month: used, limit, remaining, month, key_prefix, basis — plus credits_remaining, credits_total and an explanatory note when basis is "credits"

## Other responses

- `401` — Missing or invalid API key

---

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