---
title: "Get plan and usage for the current API key"
method: GET
path: "/v1/account/usage"
tags: ["Account"]
---

# Get plan and usage for the current API key

`GET /v1/account/usage`

## Request

- Base URL: `https://customer-api.wingbits.com`
- URL: `https://customer-api.wingbits.com/v1/account/usage`
- Auth: API key in header `x-api-key`

Returns the caller‘s subscription plan together with current rate-limit and monthly quota state — how many requests have been used, how many remain, and when the monthly counter next resets. This endpoint is free: calling it does NOT consume your monthly quota, though it is still rate limited.

## Response `200`

Default Response

- object
  - `plan` string, required: Name of the subscription plan tied to the API key.
  - `rateLimitPerMinute` number, required: Maximum number of requests allowed per minute for this API key.
  - `monthlyLimit` number, required: Total number of requests allowed in the current monthly billing period.
  - `monthlyUsed` number, required: Number of requests consumed so far in the current monthly billing period.
  - `monthlyRemaining` number, required: Number of requests still available in the current monthly billing period.
  - `periodResetAt` string, date-time, required: ISO 8601 timestamp at which the monthly usage counter next resets.
  - `features` object, required: Plan features that affect what requests are permitted.
    - `geoQueryMaxNm` number: Maximum size (in nautical miles) allowed for a geographic flight query on this plan. Absent when the plan has no geo query size limit.

## Other responses

- `401`: Default Response
- `402`: Default Response
- `429`: Default Response
- `500`: Default Response

---

[API](https://skmtc.dev/wingbits/apis/wingbits-customer-api.md) - [All operations](https://skmtc.dev/wingbits/apis/wingbits-customer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wingbits/apis/wingbits-customer-api/revisions/b67489518de1?raw)