Account Snapshot

Read your Talonic workspace account snapshot with GET /v1/account: Plan, status, credit balance, monthly allowance, API-tier daily limits, and usage today.

GET /v1/account returns a self-serve snapshot of your Talonic workspace: its Plan (the tier field) and status, your credits (balance, currency, and, on the Free plan, the monthly allowance and reset date), the per-namespace daily_limits, and usage_today. It is the single call an agent or dashboard reads to understand how much headroom is left before hitting a limit or running out of credits.

Credits are the unit of spend, governed by your Plan. The credits.balance is what remains; monthly_allowance and tier_resets_at are populated for metered Free-plan workspaces and null for paid Plans. The daily_limits are a separate axis: per-namespace throughput ceilings set by your API tier (extract, platform, ingest, operations), and usage_today is how much of each you have consumed since midnight UTC.

Response

{
  "tier": "free",
  "status": "active",
  "email_domain": "acme.com",
  "created_at": "2026-03-02T09:14:00.000Z",
  "credits": {
    "balance": 4820,
    "currency": "EUR",
    "monthly_allowance": 5000,
    "tier_resets_at": "2026-08-01T00:00:00.000Z"
  },
  "daily_limits": {
    "extract": 1000,
    "platform": 2000,
    "ingest": 1000,
    "operations": 1000
  },
  "usage_today": {
    "extract": 42,
    "platform": 118,
    "ingest": 7,
    "operations": 3
  }
}