# View Your Credit Usage

You can understand how you've used your credits, when you've used them and your historical usage patterns on the Credit Usage page.

{% hint style="info" %}
You can access the Credit Usage page from your Workspace Settings > "Credit Usage"
{% endhint %}

<figure><img src="/files/aJXcUOCN7v5oSXLCTMXf" alt="" width="563"><figcaption></figcaption></figure>

At the top, you'll see:

1. A link to a page explaining [how credits work within Roboflow](/billing/credits.md)
2. A button to the [Credit Consumption Audit Log](#credit-consumption-audit-log)
3. Your current Plan Cycle

{% hint style="info" %}
Some workspaces, including annual plans, have a "Flex Cycle" which means Flex Usage is billed on a separate interval from when their plan is billed. Learn more in the [Flex Usage section of the Credits page](/billing/credits.md#flex-usage).
{% endhint %}

There are four main tools you can use to understand your workspace's credit usage:

* [Usage Chart](#usage-chart)
* [Usage Projection](#usage-projection)
* [Current Cycle Breakdown](#current-cycle-breakdown)
* [Credit Consumption Audit Log](#credit-consumption-audit-log)

### Usage Chart

<figure><img src="/files/8WiPFYGokfmL9oF7NMDv" alt=""><figcaption></figcaption></figure>

There are several features within the Usage Chart that you can use to get a better understanding of your workspace's credit usage: (numbers reflect the labels on the image above)

#### 1. Cumulative Mode Toggle

By default, the chart is set to show your credit usage cumulatively. This means that the "bars" on the chart reflect the credits you've used within the cycle. This means, for example, if the right-most "bar" is at 15 credits, you've used 15 credits this cycle.\
\
If it's off, it will represent the daily amount you've used on credits, and it will be easier to tell spikes in the days you've used your credits the most, like the image below:<br>

<figure><img src="/files/XzGscMSESBt2Jia5NXwr" alt="" width="188"><figcaption></figcaption></figure>

#### 2. Date Range

You can select by Plan Cycle (your workspace plan billing/included-limits cycle) or a date timeframe

#### 3. Filters

You can select an "Attribution" filter and/or a "Usage Type" filter

<details>

<summary><strong>Attribution Filter:</strong> Track workspace usage for a given folder or API key</summary>

Within the Attribution filter, you can select either filtering usage attributed to an API Key or a Folder within Roboflow.\
\
This gives you the ability to track workspace usage for a given folder (which can be assigned to a specific team, group, or department) or a specific API key (which can be assigned to a specific use case, device, or deployment).\
\
**API Key Filtering**<br>

<figure><img src="/files/tcA8hDyW7ilcPwx9bBzV" alt="" width="258"><figcaption></figcaption></figure>

**Billing Folders**

This displays a hierarchical tree view of your workspace's folder structure with usage data for each folder. You can:

* Expand and collapse folders to drill into sub-folder usage
* Select or deselect folders to filter the usage chart

Usage is rolled up by default: You can deselect a parent folder to exclude its direct usage from the chart and view only its children's usage.

<figure><img src="/files/OMB5z7JZmlwyOam7Zcq2" alt="" width="358"><figcaption></figcaption></figure>

{% hint style="info" %}
Billing Folders are a premium feature. Learn more [here](/workspaces/billing-folders.md)
{% endhint %}

</details>

<details>

<summary><strong>Usage Type Filter:</strong> Filter different categories of usage or by specific features</summary>

You can filter usage to different categories or a specific feature that has credit usage. Click on the dropdowns to expand more granular options.\
\
![](/files/XsoIw3MOpy3TqQZH9A6Z)

{% hint style="info" %}
Only categories and features that have had credit usage will appear in this filter.
{% endhint %}

</details>

#### 4. Display Mode

You can choose to display by either Credits (which is the default) or Dollars, depending on your workspace's price-per-credit (which can differ by workspace, plan, and custom agreement)

### Usage Projection

The "Projection" tab lets you project your future credit usage based on recent activity.

When you open the Projection tab, you'll see:

* **Projected Credit Use** totals how many credits you're on track to consume
* **Projected Additional Credits** warns you if your usage is likely to exceed your included credits

#### Customize a Projection

Click "Customize Assumptions" to open the Scenario Builder, where you can:

* **Set the projection length** to your current cycle end, next cycle end, 3 months, 1 year, or a custom date
* **Change the basis period** to control which historical usage data informs the projection
* **Adjust per-feature usage rates** to model "what if" scenarios (for example, increasing inference volume or adding a new feature)

You can build scenarios from your current rate, customize individual feature rates, or start from scratch.

#### Save, Share, and Publish Projections

You can save a projection for future reference, share it with teammates via a link, or publish it publicly. Saved projections are accessible from the Projection tab and retain all your custom assumptions.

### Current Cycle Breakdown

In the Current Cycle Breakdown, you can see an overview of credit spend for the current billing cycle.

<figure><img src="/files/Qdz7dSRZZkipjmx9BYIB" alt="" width="563"><figcaption></figcaption></figure>

You can see a breakdown of the credits you've used in the current billing cycle, summarized by feature and broken out across Dataset, Train and Deploy

<figure><img src="/files/Ec8tpwIpivUSgMb7HVt3" alt="" width="563"><figcaption></figcaption></figure>

At the bottom of the page, you can see how close you are to Workspace Limits for:

* Team Members
* Projects

<figure><img src="/files/vEhCSGlIAnE3MTSF8x7w" alt="" width="563"><figcaption></figcaption></figure>

### Credit Consumption Audit Log

If you want to see detailed usage of your credits, click "Audit Log" at the top.

<figure><img src="/files/i216mlp4iaXyFjJg4BPE" alt="" width="375"><figcaption></figcaption></figure>

On this screen, select the date range you want to view and click Search.

This view will show you the exact feature and timestamp associated with credit usage to help give you a better idea of what actions are using credits.

<figure><img src="/files/ZVPJefffYc0l4mVwm3zO" alt="" width="563"><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.roboflow.com/billing/credits/view-credit-usage.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
