Account & usage

Current account

Returns the identity of the calling user — id, name, email, image, email-verified flag, and the scopes the current token carries. Useful for healthchecking a freshly minted key.

{
  "data": {
    "id": "user_…",
    "name": "Jane",
    "email": "jane@example.com",
    "emailVerified": true,
    "image": null,
    "createdAt": "2026-01-04T11:00:00.000Z",
    "auth": {
      "via": "token",
      "scopes": ["books:read", "books:write", "generation:run"]
    }
  }
}

Token usage rollup

Aggregated LLM token spend across the account, grouped by call kind (outline, chapter, rewrite, critique, continuity, research). Returns both lifetime totals and a 30-day rolling window, plus a list of the 50 most recent calls so you can spot a runaway job.

{
  "data": {
    "lifetime": [
      { "kind": "chapter", "inputTokens": 184201, "outputTokens": 79018, "calls": 24 },
      { "kind": "outline", "inputTokens": 4012, "outputTokens": 2810, "calls": 3 }
    ],
    "last30Days": [ … ],
    "recentCalls": [
      { "bookId": "8f1c…", "kind": "chapter", "model": "claude-sonnet-4-6",
        "inputTokens": 7100, "outputTokens": 3500,
        "createdAt": "2026-05-31T13:48:11.000Z" }
    ]
  }
}