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

# Credits

> Learn how KonbiniAPI credits and billing work. One request equals one credit, no multipliers. Failed requests are automatically refunded.

Every API request costs **1 credit**. No multipliers, no hidden costs.

## Tracking usage

Every authenticated response includes two headers:

| Header                | Description                                   |
| --------------------- | --------------------------------------------- |
| `X-Credits-Remaining` | Credits left in your account                  |
| `X-Credits-Used`      | Credits charged for this request (`1` or `0`) |

## Refunds

Requests that fail due to validation errors, server errors, or upstream platform issues are automatically refunded:

| Scenario                | Status | Credits charged |
| ----------------------- | ------ | --------------- |
| Successful request      | 2xx    | 1               |
| Validation error        | 400    | 0               |
| Server error            | 5xx    | 0               |
| Upstream platform error | 502    | 0               |

## Rate limits

There are no per-second or per-minute rate limits. You can make concurrent requests freely. The only limit is your credit balance — when credits reach zero, requests return `402`.

## When credits run out

If your account has no remaining credits, requests return a `402` status with the error code `credits_exhausted`. Upgrade your plan at [app.konbiniapi.com](https://app.konbiniapi.com) to continue.

## Pricing

Credits are included with monthly subscription plans. Unused credits do not roll over.

| Plan  | Price/mo | Credits/mo     | Per 1k credits |
| ----- | -------- | -------------- | -------------- |
| Free  | \$0      | 100 (one-time) | —              |
| Plus  | \$49     | 25,000         | \$1.96         |
| Pro   | \$99     | 55,000         | \$1.80         |
| Max   | \$199    | 160,000        | \$1.24         |
| Ultra | \$499    | 450,000        | \$1.11         |

Credits reset each billing cycle when your subscription renews.