# div limits

> Show the org's sandboxes, seats, GPUs, containers and storage against its limits, and its spend against its usage limit.

## Synopsis

```text
div limits [flags]
```

Prints what the org is using now against the most its plan allows, and its spend this period against its usage limit.

## Flags

| Flag | Description | Default |
| --- | --- | --- |
| `--json` | Print the billing summary as JSON. | |
| `--token <key>` | API key to use. | see [Configuration](https://docs.divergentlabs.xyz/compute/cli/configuration.md) |
| `--api-url <url>` | API URL to use. | see [Configuration](https://docs.divergentlabs.xyz/compute/cli/configuration.md) |

## Output

```text
Pay as you go
sandbox cores      4  of 16      running
sandboxes          9  of 25      running and stopped
seats              1  of 2
GPUs               1  of 1
containers         3  of 10
storage        12 GB  of 50 GB   as last measured
usage         $41.20  of $500.00 this period, resets 2026-10-01
```

A line at its limit is highlighted. Below the biggest plan, a final line on stderr describes the next plan up.

## Compute limits

| Limit | Pay as you go | Personal | Team |
| --- | --- | --- | --- |
| GPUs | 1 | 4 | 8 |
| Containers | 10 | 10 | 10 |
| Storage | 50 GB | 50 GB | 50 GB |

| Limit | What counts | When reached |
| --- | --- | --- |
| GPUs | GPUs held by runs and endpoint replicas | New runs are rejected with `quota_exceeded`. |
| Containers | Runs, including CPU runs, and endpoint replicas | New runs are rejected with `container_quota_exceeded`. |
| Storage | Size of all volumes, measured every 15 minutes and after each upload | Uploads are rejected with `storage_full`. |

Every plan pays for GPU time per hour from the org's credit, after the usage the plan includes. Pay as you go has no monthly fee and holds one GPU at a time. Contact us to raise a limit. Orgs on Compute Pro, which is no longer sold, keep its limits: 25 GPUs, 250 containers and 1 TB of storage.

Sandbox and seat limits depend on the plan. See [Sandbox pricing and plans](https://docs.divergentlabs.xyz/sandboxes/pricing.md).

Reaching a limit does not stop anything already running. An idle endpoint still counts toward GPUs and containers.

## Usage limit

The usage limit is an optional cap on the org's spend per period. Set it at [app.divergentlabs.xyz/billing](https://app.divergentlabs.xyz/billing). The period is the billing period on a paid plan and the calendar month (UTC) on pay as you go.

When the org reaches its usage limit, or runs out of credit without auto top-up:

- Running runs stop within a minute with the status `limit_reached`. Running sandboxes stop, and endpoints scale to zero.
- New runs are rejected with `usage_limit_reached` or `insufficient_credit`.
- Nothing restarts automatically.

## Exit codes

| Code | Meaning |
| --- | --- |
| `0` | Success. |
| `1` | The API rejected the request. |
| `2` | Invalid flags, or no API key. |

## Examples

```bash
div limits
div limits --json
```
