# Check and refill budgets

Last validated Jun 24, 2026

\[Missing snippet: aperture\_release\_note.mdx]

After you configure [per-user spending limits][kb-aperture-set-per-user-spending-limits] or a [team-wide budget][kb-aperture-set-team-budget], you can check how budgets are being consumed and manually refill depleted buckets.

## Prerequisites

Before you begin, ensure you have the following:

* An [Aperture instance][kb-aperture-get-started] with quotas configured. Refer to the [quotas configuration reference][kb-aperture-quotas] for details.
* Network access to the Aperture host URL (default: `http://ai`).
* [Admin access][kb-aperture-set-up-admin-access] to refill buckets. Checking status does not require admin access.

## Check quota status in the dashboard

The **Models** page in the [Aperture dashboard][kb-aperture-dashboard] displays quota status alongside each model's pricing. When quotas are configured, the pricing tooltip shows the applicable bucket names, current balance, refill rate, and last updated timestamp.

## Check quota status using the API

Query the `GET /api/quotas` endpoint to retrieve the current status of all quota buckets:

```shell
curl http://ai/api/quotas
```

The response includes each bucket's name, current balance, capacity, and refill rate.

## Refill a quota bucket

Admins can manually add funds to a depleted bucket using the `POST /api/quotas/refill` endpoint:

```shell
curl -X POST http://ai/api/quotas/refill \
  -H "Content-Type: application/json" \
  -d '{"bucket": "daily:alice@example.com", "amount": "$5.00"}'
```

Replace the `bucket` value with the name of the bucket to refill. The `amount` value adds to the current balance up to the bucket's configured `capacity`. Aperture does not allow the balance to exceed `capacity`.

> **Note:**
>
> Only users with [admin access][kb-aperture-set-up-admin-access] can refill quota buckets.

## Next steps

* [Set per-user spending limits][kb-aperture-set-per-user-spending-limits] if you have not configured individual budgets yet.
* [Set a team-wide budget][kb-aperture-set-team-budget] to cap total organizational spending.
* [Export usage data to S3][kb-aperture-export-s3] for long-term cost analysis and reporting.

[kb-aperture-dashboard]: /docs/aperture/reference/dashboard

[kb-aperture-export-s3]: /docs/aperture/how-to/export-usage-data-to-s3

[kb-aperture-get-started]: /docs/aperture/get-started

[kb-aperture-quotas]: /docs/aperture/configuration#quotas

[kb-aperture-set-per-user-spending-limits]: /docs/aperture/how-to/set-per-user-spending-limits

[kb-aperture-set-team-budget]: /docs/aperture/how-to/set-team-budget

[kb-aperture-set-up-admin-access]: /docs/aperture/how-to/set-up-admin-access