---
title: "Returns API subscription usage counters for the current key."
method: GET
path: "/subscription/usage"
tags: ["Account"]
---

# Returns API subscription usage counters for the current key.

`GET /subscription/usage`

Returns current usage counters, remaining request quotas, and reset timestamps for standard and historical Weatherbit products. Daily request limits reset at 00:00 UTC.

## Query parameters

- `key` string, string, required

## Response `200`

Subscription usage object.

- SubscriptionUsage
  - `calls_count` string, nullable — Current call count for the key/subscription.
  - `calls_remaining` integer, nullable — Remaining calls before reset.
  - `calls_reset_ts` integer, nullable — Usage reset timestamp.
  - `historical_calls_count` string, nullable — Historical product call count when available.
  - `historical_calls_remaining` integer, nullable — Remaining historical calls before reset.
  - `historical_calls_reset_ts` integer, nullable — Historical usage reset timestamp.

## Other responses

- `400` — Client Error
- `403` — Unauthorized/No Access for current plan level
- `429` — Daily or Velocity limit exceeded
- `500` — Internal Server Error

---

[API](https://skmtc.dev/weatherbit/apis/weatherbit-interactive-swagger-ui-documentation.md) · [All operations](https://skmtc.dev/weatherbit/apis/weatherbit-interactive-swagger-ui-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/weatherbit/weatherbit-interactive-swagger-ui-documentation/revisions/31cff6bde48b/schema)