---
title: "Inspect API key validity and fitting availability"
method: GET
path: "/v1/key/status"
---

# Inspect API key validity and fitting availability

`GET /v1/key/status`

## Request

- Base URL: `https://api.eldrick.com`
- URL: `https://api.eldrick.com/v1/key/status`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://api.eldrick.com/oauth/authorize`, token URL `https://api.eldrick.com/oauth/token`)

## Response `200`

Key status with included allowance and purchased credits reported separately

- KeyStatusResponse
  - `valid` unknown, required
  - `developer` object, required
    - `companyName` string, required
    - `email` string, email, required
    - `tier` string, required: Internal entitlement label; clients should use structured usage fields for billing availability.
  - `usage` object, required
    - `current` integer, required: All counted fitting requests in the current month.
    - `limit` integer, nullable, required
    - `remaining` integer, nullable, required
    - `percentUsed` integer, required
    - `unlimited` boolean, required
    - `creditBased` boolean, required
    - `resetsAt` string, date-time, required
    - `includedLimit` integer, nullable, required
    - `includedUsed` integer, required
    - `includedRemaining` integer, nullable, required
    - `purchasedCreditBalance` integer, required
    - `availability` 'included' | 'credit' | 'exhausted' | 'enterprise' | 'unlimited', required
    - `nextFittingSource` 'included' | 'purchased_credit' | 'enterprise' | 'unlimited' | 'unavailable', required

## Other responses

- `401`: Unauthorized

---

[API](https://skmtc.dev/eldrick/apis/eldrick-golf-fitting-api.md) · [All operations](https://skmtc.dev/eldrick/apis/eldrick-golf-fitting-api/llms.txt) · [OpenAPI document](https://skmtc.dev/eldrick/apis/eldrick-golf-fitting-api/revisions/9469c1821a83?raw)