Account

Get your account

GET /me

Return your account snapshot: the shared ecosystem balance and tier that jobs draw on, your rate, and which paid features your plan includes. This is the same balance the FluidTalk conversations spend and the same number the dashboard shows. Requires authentication.

Response — 200 OK

{
  "ownerId": "1d970780-…",
  "balance": 42.75,
  "tier": "pro",
  "planName": "Creator",
  "unitPrice": { "image": 0.016, "video": 0.08 },
  "features": { "ultraSafe": false }
}

Field	Type	Notes
ownerId	string	Your account id.
balance	number | null	Shared balance in tokens (1 token = $1). null when billing is inert or the balance authority is unreachable.
tier	string | null	Your plan tier. null when unavailable.
planName	string	The plan's customer-facing name — pro is sold as "Creator". Derived from the same normalisation the charge uses, so it can never disagree with your rate.
unitPrice	object	USD per produced copy on this plan, by media kind.
features	object	Paid features your plan includes. ultraSafe is Ultra Safe — Agency and higher. Check it before offering the option; a job that asks for a feature you don't have is refused 403.

Use this to show remaining balance before submitting a large batch. Job costs are debited per variant; a job that the balance can't cover is refused with 402 insufficient_balance. See Billing. Top-ups happen in the dashboard, not the API.

---

Usage

GET /usage?days=30

What the account used over the last days UTC calendar days, today included (days 1–90, default 30), plus team seats and storage. Dashboard session only: a request made with an API key returns 403 forbidden.

{
  "days": 30,
  "since": "2026-09-19T00:00:00.000Z",
  "photos": 13600,
  "videos": 0,
  "ultraSafePhotos": 4620,
  "spendUsd": 190.4,
  "seats": { "used": 5, "limit": 6 },
  "storage": { "usedBytes": null, "limitBytes": 536870912000 }
}

Field	Notes
photos / videos / ultraSafePhotos	Output copies of jobs created in the window, from the dashboard and from API keys.
spendUsd	What your balance was debited for those jobs when they were created.
seats	Team members plus pending invites, against your plan's seat limit (-1 = unlimited). null when it cannot be read for you (for example, you are a team member, not the account owner).
storage.usedBytes	Your FluidCloud storage in use, or null when it cannot be read.
storage.limitBytes	Your plan's storage quota, or null when unknown.