API Keys

Api Keys Trial Status

Read-only status for the user's active SDK developer trial.

User-sim Item D follow-on (2026-05-06): the FE settings panel polls this to render "X of 100 used today / N days left" without burning a real API call. Returns:

  • 200 {"status": "ok", "active": false} if user has no trial
  • 200 {"status": "ok", "active": true, "key_prefix": "...", "days_remaining": N, "count_today": M, "daily_cap": 100, "trial_started_at": "..."}

Cheap (one indexed SELECT + one indexed COUNT). Safe to poll. Does NOT bump the daily counter — pure observability surface.

get/api/keys/trial-status

Request

  • Base URL: https://www.oxfordledge.com (the document declares no server; this is the origin it was published from)
  • URL: https://www.oxfordledge.com/api/keys/trial-status
  • Auth: none declared

Response

Successful Response

statusstring required

'ok' on success

activeboolean required

True if user has an active (non-revoked) trial key

key_prefixstring nullable

Stable key prefix; None when no active trial

namestring nullable

Human-readable key name; None when no active trial

days_remaininginteger nullable

Whole days until trial expires; None when no active trial

count_todayinteger nullable

Count of trial calls used today (ET-anchored); None when no active trial

daily_capinteger nullable

Per-day call quota (100 when active); None when no trial

trial_window_daysinteger nullable

Window length in days (14); None when no active trial

trial_started_atstring nullable

ISO 8601 timestamp of trial issuance; None when no trial

Example response

{
  "status": "ok"
}

Changes

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