> ## Documentation Index
> Fetch the complete documentation index at: https://docs.baseten.co/llms.txt
> Use this file to discover all available pages before exploring further.

# baseten org billing

> View billing information

## usage

```sh theme={"system"}
baseten org billing usage [OPTIONS]
```

Show a billing usage summary for the organization, broken down into dedicated deployments, model APIs, and training. Pass `--since` (relative duration, e.g. 7d, 24h) for a sliding window ending now, or `--start` and `--end` together for an explicit ISO 8601 range. The two modes are mutually exclusive. The range cannot exceed 31 days and cannot start before 2026-01-01 UTC. Defaults to `--since` 7d.

### Options

<ParamField body="--end" type="TEXT">
  End of the window. Accepts ISO 8601; values without a timezone are interpreted in the local timezone. Requires --start. Mutually exclusive with --since.
</ParamField>

<ParamField body="-q, --jq" type="TEXT">
  Filter JSON output with a jq expression; implies --output json (or jsonl for streamed commands)
</ParamField>

<ParamField body="-o, --output" type="TEXT" default="text">
  Output format

  One of: `text`, `json`, `jsonl`, `none`
</ParamField>

<ParamField body="--profile" type="TEXT">
  Use a specific stored profile for this command, overriding BASETEN\_PROFILE and the current profile
</ParamField>

<ParamField body="--since" type="TEXT">
  Relative window ending now (e.g. 24h, 7d). Used when neither --start nor --end is given. Maximum 31d. Mutually exclusive with --start/--end.
</ParamField>

<ParamField body="--start" type="TEXT">
  Start of the window. Accepts ISO 8601 (e.g. '2026-05-01', '2026-05-01T12:00:00Z'); values without a timezone are interpreted in the local timezone. Requires --end. Mutually exclusive with --since.
</ParamField>

<ParamField body="-v, --verbose" type="BOOL">
  Enable verbose logging
</ParamField>

### Examples

Show usage over the last 7 days (default)

```sh theme={"system"}
baseten org billing usage
```

Show usage over the last 30 days

```sh theme={"system"}
baseten org billing usage --since 30d
```

Show usage over an explicit ISO 8601 range

```sh theme={"system"}
baseten org billing usage --start 2026-05-01 --end 2026-05-08
```

### Filter output with `--jq`

Print the total cost of model API usage

```sh theme={"system"}
baseten org billing usage --jq '.model_apis_usage.total'
```

### Output

**Text mode (`--output text`):** The resolved window on stderr, then a table on stdout with one row per category present (Dedicated, Model APIs, Training), plus an "All" total row when more than one category is present, with columns CATEGORY, MINUTES, TOTAL, CREDITS, SUBTOTAL. Costs are in USD; SUBTOTAL is the net cost after credits. Prints "No usage in the selected window." to stderr when every category is absent.

**JSON mode (`--output json`):** payload type `managementapi.UsageSummary`.

The usage summary: optional dedicated\_usage, model\_apis\_usage, and training\_usage objects, each with total/credits\_used/subtotal costs and a per-resource breakdown whose items each carry an optional daily series.