Account | Fous API Reference

The Account object

organizationobject
Show child attributesHide child attributes
- idstring
- namestring
creditsobject
Show child attributesHide child attributes
- balanceinteger
  Whole credits (1 credit = $0.01).
- balance_usdnumber
  The balance in US dollars.
limitsobject
The plan’s limits.
Show child attributesHide child attributes
- requests_per_minuteinteger
  Calls a minute, counted apart for runs and queries and for searches, builds and sign-ins.
- concurrent_runsinteger
  Runs and queries going at once.
- monthly_spend_limit_creditsnumber or null
  The organization’s monthly spend limit, in credits; null: no limit.
buildsobject
Show child attributesHide child attributes
- free_per_monthinteger
  Public builds a month that cost nothing.
- used_this_monthinteger
  Builds this month so far.
pricesobject
What each call costs, in credits.
Show child attributesHide child attributes
- searchinteger
  A search: free.
- runinteger
  A run that completes.
- queryinteger
  A query that answers.
- build_after_allowanceinteger
  A public build once the month’s free builds are used.
- private_buildinteger
  A private build, always.
keyobject
The key this call was made with.
Show child attributesHide child attributes
- kindstring
  user: a key created in Fous Studio. agent: a key an agent got by connecting itself.
  useragent
- namestring
- client_namestring or null
  agent: the agent that connected.
- expires_atstring or null
  When the key stops working; null: never.
- last_used_atstring or null

Account

{  "organization": {    "id": "org_01M4CD7TVHDBPFQHZD05XMW5PB",    "name": "Agent Test"  },  "credits": {    "balance": 585,    "balance_usd": 5.85  },  "limits": {    "requests_per_minute": 60,    "concurrent_runs": 8,    "monthly_spend_limit_credits": null  },  "builds": {    "free_per_month": 20,    "used_this_month": 9  },  "prices": {    "search": 0,    "run": 1,    "query": 5,    "build_after_allowance": 100,    "private_build": 100  },  "key": {    "kind": "user",    "name": "Server",    "client_name": null,    "expires_at": null,    "last_used_at": "2026-10-23T09:11:15.000Z"  }}

Get the account

The organization behind the key: credit balance, plan limits, monthly build allowance and prices. Free.

Returns

An Account object.

200The account.

curl 'https://api.fous.com/v1/account' \  -H "Authorization: Bearer $FOUS_API_KEY"

// Save as fous.mts, then run: npx tsx fous.mtsconst response = await fetch('https://api.fous.com/v1/account', {  headers: {    Authorization: `Bearer ${process.env.FOUS_API_KEY}`,  },});const result = await response.json();if (!response.ok) throw new Error(`${result.error.code}: ${result.error.message}`);console.log(result);

import osimport requestsresponse = requests.get(    "https://api.fous.com/v1/account",    headers={        "Authorization": f"Bearer {os.environ['FOUS_API_KEY']}",    },    timeout=180,)result = response.json()if not response.ok:    raise RuntimeError(f"{result['error']['code']}: {result['error']['message']}")print(result)

Sent with your key, kept for this tab only. A run uses credits like any call.

Response 200

{  "organization": {    "id": "org_01M4CD7TVHDBPFQHZD05XMW5PB",    "name": "Agent Test"  },  "credits": {    "balance": 585,    "balance_usd": 5.85  },  "limits": {    "requests_per_minute": 60,    "concurrent_runs": 8,    "monthly_spend_limit_credits": null  },  "builds": {    "free_per_month": 20,    "used_this_month": 9  },  "prices": {    "search": 0,    "run": 1,    "query": 5,    "build_after_allowance": 100,    "private_build": 100  },  "key": {    "kind": "user",    "name": "Server",    "client_name": null,    "expires_at": null,    "last_used_at": "2026-10-23T09:11:15.000Z"  }}