Workspace Plan and Usage

Read your workspace's plan and usage from the Python SDK.

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

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

usage = workspace.get_usage()
print(usage)

The response is the same JSON that drives the workspace's billing usage report in the web app - 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 for the raw REST endpoint.

CLI equivalent

roboflow workspace plan
roboflow workspace usage