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

# Understanding Credits, Usage, and Budget Management

> How credits work, when they reset, how to view usage, set budgets, and manage billing on Unbound

## How Credits Work in Unbound

Unbound uses a credit-based system for API usage. Each API request consumes credits based on:

* The **model** used (e.g., Claude Opus costs more than Claude Haiku)
* The number of **tokens** processed (input + output)

## When Do Credits Reset?

Credits reset on the **1st of every calendar month**. Your monthly allocation is refreshed automatically. There is no manual reset option.

## How to View Your Usage

<Steps>
  <Step title="Log in to your Unbound dashboard">
    Go to [gateway.getunbound.ai](https://gateway.getunbound.ai) or your custom domain.
  </Step>

  <Step title="Navigate to usage analytics">
    Click **Home** in the sidebar, or go to **Analytics → Overview** for detailed breakdowns.
  </Step>

  <Step title="Review your usage">
    You'll see analytics including:

    * Total spend
    * Number of requests
    * Token consumption
    * Per-model breakdown
  </Step>

  <Step title="Filter by date">
    Use the date filters to view usage for specific time periods. For monthly usage, select the current calendar month range.
  </Step>
</Steps>

<Tip>
  Unbound provides deep usage insights at user, team, and department levels. Organization admins can see usage breakdowns for each team member.
</Tip>

## "Application Credits Not Available" Error (402)

This error means your account has run out of credits for the current billing period.

**How to resolve:**

1. **Use a free-tier model** — Some models don't consume credits. Check the **Models** page for free-tier options
2. **Contact your administrator** — Ask them to add more credits or increase the monthly budget
3. **Wait for reset** — Credits automatically refresh on the 1st of next month

<Warning>
  A 402 error does **NOT** mean your API key is invalid. Your key is fine — you've simply used all your credits.
</Warning>

## How to Set or Adjust a Monthly Budget

Organization administrators can set and modify budgets:

<Steps>
  <Step title="Go to Settings">
    Click **Settings** in the left sidebar (Admin only).
  </Step>

  <Step title="Navigate to budget configuration">
    Find the budget section.
  </Step>

  <Step title="Set your monthly budget">
    Enter the desired amount in USD.
  </Step>

  <Step title="Save your changes">
    Click **Save** to apply the new budget.
  </Step>
</Steps>

You can also manage **per-user budgets** from the **Users** page by selecting a user and adjusting their individual allocation.

## "You Are Not Authorized to Make Changes for Both Budget and Models"

This error appears when you don't have admin permissions.

**Who can modify budgets and models:**

* Organization administrators only

**What to do:** Contact your organization administrator to make these changes on your behalf.

## Usage Limits

Usage limits can be configured at multiple levels by your organization administrator:

* **Per tool** — Monthly budget cap on each connected tool
* **Per user** — Individual user spending limits
* **Per model** — Restrict which models are available

If you're hitting a limit unexpectedly, check with your admin about your current allocation.

## Invoices and Billing

### Where to find invoices

Invoices are available in the **Billing** section of your dashboard sidebar (Admin access required).

### Auto top-up

For auto top-up configuration, go to **Billing → Payment Settings** or contact your account manager for enterprise billing arrangements.

### Can't find invoices?

If you cannot locate invoices in the UI, contact support with your organization name and we'll provide invoice history directly.

## Free Trial / Free Credits

If you'd like to try Unbound before committing, contact our sales team to discuss trial options and free credits for evaluation.

<CardGroup cols={2}>
  <Card title="Cost Policies" icon="dollar-sign" href="/policies/cost-policies">
    Set monthly budget limits and spending controls per team
  </Card>

  <Card title="Analytics" icon="chart-line" href="/analytics">
    Track spend by user, model, and tool in real time
  </Card>
</CardGroup>