api reference

Usage

GET /v1/usage: balance, spend and the free allowance.

GET/v1/usageAuthenticated

GET /v1/usage. The calling organization's balance, spend and free allowance. The organization comes from the key, never from a parameter, so you can only see your own. Needs a valid key and no balance.

Query parameters

from, optional. An ISO 8601 timestamp with an offset. Defaults to the start of the current month, UTC.
to, optional. Same format. Defaults to now. Must be after from.
The range may not exceed 366 days. Otherwise the call is a 400 invalid_request.

bash

curl "https://api.hohelabs.com/v1/usage?from=2026-10-01T00:00:00Z" \
  -H "Authorization: Bearer $HOHE_API_KEY"

json

{
  "object": "usage",
  "period": {
    "from": "2026-10-01T00:00:00.000Z",
    "to": "2026-10-15T09:13:02.000Z"
  },
  "balance": { "credits": 100000, "overdraft_limit": 1000 },
  "totals": {
    "requests": 3,
    "units": 412,
    "credits_charged": 0,
    "failed_requests": 1
  },
  "by_operation": [
    { "operation": "asr.transcribe", "requests": 3, "units": 412, "credits_charged": 0 }
  ],
  "free_allowance": [
    {
      "operation": "asr.transcribe",
      "unit": "audio_second",
      "per_month": 7200,
      "remaining": 6788,
      "resets_at": "2026-11-01T00:00:00.000Z"
    }
  ]
}

Fields

balance: credits and overdraft_limit. null if the organization has no credit account.
totals: requests, units and credits charged in the period, plus failed_requests. Failed requests are counted separately and carry no units or credits.
by_operation: the same totals per operation.
free_allowance: for each operation with a free allowance, the monthly amount, what remains this month, and when it resets. This is always the current month, whatever range you asked for.

All documentation