Introspect this API key's scopes and rate-limit status

Stage 104 Part C: returns the calling key's real granted scopes, which of the six v1 endpoints each is currently allowed to call, and the current rate-limit tier/window usage — call this before attempting an endpoint to avoid discovering a 403 insufficient_scope or a 429 rate_limited only by triggering it. Open to any valid key regardless of its own scopes (no scope requirement), and read-only against the rate limit: checking never spends any of the key's own budget.

get/introspect

Request

  • Base URL: https://localselections.com/api/v1
  • URL: https://localselections.com/api/v1/introspect
  • Auth: API key in header X-API-Key

Response

The key's real current scopes, per-endpoint access, and rate-limit usage.

scopesstring[] required

The raw scopes array stored on this key, e.g. ["all"] or ["spin", "search"].

commercialboolean required

Stage 198: true only after the owner has contacted us and been granted a paid commercial license. A commercial key is exempt from the free-tier daily ceiling on places/events/movies (see those paths' own 429 daily_limit_exceeded response) — its real limits are whatever was negotiated in that license, not enforced by this API.

Changes

No recorded changes to this operation across all 1 revision of this API.