> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/developer/python-sdk/workspace-plan-and-usage.md).

# Workspace Plan and Usage

`Workspace.get_plan()` returns the workspace's billing plan, included credits, and feature limits. `Workspace.get_usage()` returns the corresponding usage report (inference calls, training credits, image counts).

These are useful for embedding billing dashboards in internal tools and for guard-railing automation that consumes paid credits.

## Get plan

```python
import roboflow

rf = roboflow.Roboflow(api_key="YOUR_API_KEY")
workspace = rf.workspace()

plan = workspace.get_plan()
print(plan["name"])             # e.g. "growth"
print(plan.get("limits", {}))   # included image / inference / training quotas
```

## Get usage

```python
usage = workspace.get_usage()
print(usage)
```

The response is the same JSON that drives the workspace's [billing usage report in the web app](https://app.roboflow.com/) - month-to-date image uploads, training credits consumed, and hosted/dedicated inference counts.

## REST equivalent

The same data is exposed at:

* `GET /usage/plan` - plan info
* `POST /:workspace/billing-usage-report` - usage breakdown

See [Billing Folders Usage Report](/developer/rest-api/billing-folders-usage-report.md) for the raw REST endpoint.

## CLI equivalent

```bash
roboflow workspace plan
roboflow workspace usage
```