# Billing and credits

> What search, runs, queries and builds cost, when credits are charged, and where to manage credits, limits and spending.

Source: https://docs.fous.com/guides/billing
Index: https://docs.fous.com/llms.txt

| Activity | Price |
| --- | --- |
| Search, method details, run and build status, the account | Free |
| A completed run | 1 credit |
| A query that answers | 5 credits |
| A public build within your plan's monthly allowance | Free |
| A public build beyond the allowance, or a private build | 100 credits |
| Repairs, and anything that fails or is cancelled | Free |

One credit is $0.01 at pay-as-you-go prices. Plans are on [fous.com/pricing](https://fous.com/pricing).

- A query holds 5 credits and charges them for any answer, even partial. No answer gives them back.
- A build holds 100 and charges only when it makes a method or a version. An in-place improvement is free and does not use the allowance. Changing your own private method is not charged as private again.

## Limits and spending

`GET /v1/account` shows your balance, limits, free builds and prices:

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

```json
{
  "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"
  }
}
```

In [Studio](https://app.fous.com), **Billing** holds credits, plans and auto-recharge. **Usage** shows spending, and its **Limits** tab sets a monthly spend limit and alerts. A call your credits or spend limit do not cover is refused, free:

```json
{
  "error": {
    "code": "insufficient_credits",
    "message": "This run costs 1 credit, and your organization has 0.",
    "next_step": "Add credits at https://app.fous.com/billing. Nothing was charged.",
    "required_credits": 1,
    "available_credits": 0,
    "billing_url": "https://app.fous.com/billing",
    "doc_url": "https://docs.fous.com/guides/errors#insufficient_credits",
    "request_id": "req_mh7c2k9xQ1v3Zt8LbN0pRwY4"
  }
}
```

Negotiated agreements are managed in Studio under **Billing**. Questions: [billing@fous.com](mailto:billing@fous.com).
