---
title: "Your key's tier, quota, and usage this month"
method: GET
path: "/v1/usage"
tags: ["account"]
---

# Your key's tier, quota, and usage this month

`GET /v1/usage`

## Request

- Base URL: `https://api.filingpulse.io`
- URL: `https://api.filingpulse.io/v1/usage`
- Auth: API key in header `X-API-Key`

Introspection for the calling key: tier, monthly quota, requests used and
remaining this month, per-minute rate limit, and webhook slots. The numbers come
from the same counters the limits are enforced with (UTC calendar month, resets at
00:00 UTC on the 1st — `quota_resets_at` is the exact instant), so they cannot
disagree with a 429 you just received. Calling this endpoint does NOT count against
the monthly quota; it does count toward the per-minute rate limit.
`webhooks.limit` is null on tiers with unlimited subscriptions.

## Response `200`

Successful Response

- unknown

## Other responses

- `401`: Missing or invalid X-API-Key.
- `429`: Per-minute rate limit exceeded (Retry-After header). This endpoint never consumes the monthly quota, so it keeps working after a quota 429.

---

[API](https://skmtc.dev/filingpulse/apis/filingpulse-api.md) · [All operations](https://skmtc.dev/filingpulse/apis/filingpulse-api/llms.txt) · [OpenAPI document](https://skmtc.dev/filingpulse/apis/filingpulse-api/revisions/631622c4ba5e?raw)