Skip to main content
GET
API key usage history + balance
Auth: Required · Cost: Free (no charge) · Use case: Balance visibility for self-service dashboards + pre-flight checks
Returns the same data shown in your kabinet at app.aegis-kyt.com/account?tab=api. Single source of truth — rows from user_api_usage, billing snapshot from the same ledger as GET /v2/balance. Use this endpoint to:
  • Surface “X credits remaining” inside your own admin UI.
  • Detect an empty balance or a monthly cap about to bite before firing a paid call (avoids a 402 round-trip).
  • Audit which addresses your key has screened (CSV / SOC2 reporting).

Request

Response 200

billing object

This block carries only the *_usd fields. For the same numbers with the *_credits twins and unit: "credits", call GET /v2/balance.

rows[] — usage history

Each row mirrors one entry in user_api_usage.

Pagination

Errors

Notes

  • This endpoint is free — call it as often as you like.
  • Best-effort write semantics on user_api_usage: in extremely rare cases (Supabase write fails) a paid call’s row may be missing. Billing is unaffected — it’s computed from the balance ledger on the hot path, not from this audit table.

See also

Authorizations

Authorization
string
header
required

Your aeg_… API key from the dashboard (Account → API tab).

Query Parameters

page
integer
default:1
Required range: x >= 1
limit
integer
default:20
Required range: 1 <= x <= 100
since
string | null

ISO date; only rows with created_at >= since

Response

Successful Response

The response is of type Response Me Usage Me Usage Get · object.