# Get the caller's plan usage for the current period and the plan catalog.

`GET /o/{org}/billing`

Any org member, or an API key of the org (scope `runs:read`), which reads its creator's billing. Billing is per user, not per org: the usage is the caller's own billing account whichever org is in the path. `creditBalanceUsd` is what developer runs have left; it can read a little below 0 when model calls already in flight finished past $0, and that amount comes off the next purchase. Changing the plan, buying credits and setting the spend limit or auto-reload take a person in the console. This is the console's billing document, unchanged for keys: its fields are camelCase and `capUsd` and `autoReload` are `null` when not set.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `org` | path | string | yes | The org's slug or id. A caller with no role in the org gets `404`. |

## Example request

```bash
curl "https://api.phoenix.so/o/$RUSH_ORG/billing" \
  -H "Authorization: Bearer $RUSH_TOKEN"
```

```typescript
const org = process.env.RUSH_ORG;

const res = await fetch(`https://api.phoenix.so/o/${org}/billing`, {
  headers: {
    Authorization: `Bearer ${process.env.RUSH_TOKEN}`,
  },
});

console.log(res.status, await res.json());
```

```python
import os

import requests

org = os.environ["RUSH_ORG"]

res = requests.get(
    f"https://api.phoenix.so/o/{org}/billing",
    headers={"Authorization": f"Bearer {os.environ['RUSH_TOKEN']}"},
)

print(res.status_code, res.json())
```

## Responses

### 200

Usage plus every plan.

- `plans` (array of BillingPlan, required): Every plan, so a client that keeps a write's answer still has the catalog.
  - `slug` (string, required, one of `free`, `pro`, `max`)
  - `name` (string, required)
  - `monthlyPriceUsd` (number, required): Per member a month.
  - `includedComputeMinutes` (integer, required): Minutes each seat adds to the pool a month (Free: the whole org).
  - `includedComputeMinutesPerWeek` (integer, required): Minutes each seat adds to the week's window.
  - `maxConcurrentRuns` (integer, required): Runs at once per member.
  - `requiresPaymentMethod` (boolean, required)
- `plan` (string, required, one of `free`, `pro`, `max`): The org's plan: its owner's, which every member's runs share.
- `seats` (integer, required): Seats the plan pays for; each adds the plan's hours to the pool. Free, and a subscription on a flat price, count one.
- `members` (integer, required): The org's members, its owner included. A per-member plan's seats follow it within minutes.
- `managesBilling` (boolean, required): Whether the caller is the org's owner, the one person who may change the plan.
- `planEndsAt` (string, optional): When the plan ends and the account moves to Free (a move to Free, or a cancel in the billing portal). Absent while the plan renews.
- `hasPaymentMethod` (boolean, required)
- `periodStart` (string, required): The org's billing cycle, which the pool of hours resets on.
- `periodEnd` (string, required)
- `periodUsedUsd` (number, required): Billed USD this period, including in-flight compute.
- `capUsd` (number | null, required): The spend cap; null when none is set.
- `computeMinutesUsed` (number, required): Minutes of the org's pool used this period by its members' own runs: a run started with an API key never uses them.
- `computeMinutesIncluded` (number, required): The pool: the plan's minutes times its seats; -1 means no ceiling (an admin account).
- `weekStart` (string, required)
- `weekEnd` (string, required)
- `weeklyComputeMinutesUsed` (number, required)
- `weeklyComputeMinutesIncluded` (number, required): The week's included minutes; -1 means no weekly ceiling (an admin account, or a plan whose week is not below its month, such as Free).
- `maxConcurrentRuns` (integer, required): Runs at once; 9007199254740991 (Number.MAX_SAFE_INTEGER) on an admin account.
- `tokenSpendUsd` (number, required): What the Free plan's $1 has paid, raw vendor cost: the person's own runs' Rush-paid model calls and, on Free, their compute. API key and MCP runs never count. It never resets.
- `tokenSpendIncluded` (number, required): The one-time free credit for a Free person's own runs, AI model and compute: $1 on Free; 0 on a paid plan, whose runs use the person's own Claude or ChatGPT subscription or API key, and on the no-Free-plan side of the billing-free-plan test; -1 on an admin account.
- `freePlanTest` (string, optional, one of `control`, `no-free-plan`): The account's side of the billing-free-plan test: on `no-free-plan` there is no Free plan and runs need Pro or Max. Absent for an account from before the test.
- `creditsGrantedUsd` (number, required): Every credit the caller has bought. 0 for an account that never bought any.
- `creditBalanceUsd` (number, required): Credits left: bought, less what usage has cost, debited or not yet. At or below 0 an account that bought credits gets `402 CREDITS_EXHAUSTED`; it can read a little below 0 when calls in flight finished past it.
- `autoReload` (object | null, required): Under `belowUsd`, charge the saved card `addUsd` of credits; null when off. Auto-reload adds at most $500 in any rolling 30 days; past that it charges nothing until older reloads age out.
  - `belowUsd` (integer, required)
  - `addUsd` (integer, required)
  - `paused` (boolean, optional, one of `true`): Present when the next reload would pass the $500 in 30 days ceiling, so none is charged. Credits bought by hand are not limited.
  - `pausedUntil` (string, optional): When a reload of `addUsd` fits under the ceiling again. Absent when `addUsd` alone is above it.

### 401

No bearer, an unknown, revoked or expired one, or an API key on a route keys cannot call.

### 404

No such resource for the caller, including one in an org the caller is not in or a Project that is private to someone else.

### 429

The account is over its request budget, 1,800 a minute shared by the person's API keys and console on every API host (`RATE_LIMITED`). The error names the limit. Wait `Retry-After` seconds.

## Example response (200)

```json
{
  "plans": [
    {
      "slug": "free",
      "name": "string",
      "monthlyPriceUsd": 0,
      "includedComputeMinutes": 0,
      "includedComputeMinutesPerWeek": 0,
      "maxConcurrentRuns": 0,
      "requiresPaymentMethod": true
    }
  ],
  "plan": "free",
  "seats": 1,
  "members": 1,
  "managesBilling": true,
  "planEndsAt": "2026-10-06T12:00:00Z",
  "hasPaymentMethod": true,
  "periodStart": "2026-10-06T12:00:00Z",
  "periodEnd": "2026-10-06T12:00:00Z",
  "periodUsedUsd": 0,
  "capUsd": 0,
  "computeMinutesUsed": 0,
  "computeMinutesIncluded": 0,
  "weekStart": "2026-10-06T12:00:00Z",
  "weekEnd": "2026-10-06T12:00:00Z",
  "weeklyComputeMinutesUsed": 0,
  "weeklyComputeMinutesIncluded": 0,
  "maxConcurrentRuns": 0,
  "tokenSpendUsd": 0,
  "tokenSpendIncluded": 0,
  "freePlanTest": "control",
  "creditsGrantedUsd": 0,
  "creditBalanceUsd": 0,
  "autoReload": {
    "belowUsd": 1,
    "addUsd": 10,
    "paused": true,
    "pausedUntil": "2026-10-06T12:00:00Z"
  }
}
```
