Account

API key account introspection: plan, rate limits, and usage.

Get plan and usage for the current API key

get

http://localhost:3002https://customer-api.wingbits.com

/v1/account/usage

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.

Authorizations

apiKeyAuth

x-api-keystringRequired

API key for accessing protected endpoints

Responses

200

Default Response

application/json

planstringRequired

Name of the subscription plan tied to the API key.

rateLimitPerMinutenumberRequired

Maximum number of requests allowed per minute for this API key.

monthlyLimitnumberRequired

Total number of requests allowed in the current monthly billing period.

monthlyUsednumberRequired

Number of requests consumed so far in the current monthly billing period.

monthlyRemainingnumberRequired

Number of requests still available in the current monthly billing period.

periodResetAtstring · date-timeRequired

ISO 8601 timestamp at which the monthly usage counter next resets.

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$

401

Default Response

application/json

402

Default Response

application/json

429

Default Response

application/json

500

Default Response

application/json

get/v1/account/usage

HTTPcURLJavaScriptPython

GET /v1/account/usage HTTP/1.1
Host: localhost:3002
x-api-key: YOUR_API_KEY
Accept: */*

{
  "plan": "text",
  "rateLimitPerMinute": 1,
  "monthlyLimit": 1,
  "monthlyUsed": 1,
  "monthlyRemaining": 1,
  "periodResetAt": "2026-08-07T13:40:45.879Z",
  "features": {
    "geoQueryMaxNm": 1
  }
}