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

# Billing

> How PSNTools API usage is metered, quoted, and charged.

<Note>
  Placeholder. The API is not live yet — no pricing, quota, or rate-limit figures on this page are final.
</Note>

## How usage is counted

One billable unit is one successful API call. Requests that fail with `4xx` or `5xx` are not billed, and sandbox keys (`psn_test_`) are never billed.

## Quotas by tier

API quota is expected to follow your existing membership tier rather than being sold separately.

| Tier     | Included calls / month | Rate limit |
| -------- | ---------------------- | ---------- |
| Bronze   | TBC                    | TBC        |
| Silver   | TBC                    | TBC        |
| Golden   | TBC                    | TBC        |
| Platinum | TBC                    | TBC        |

## Rate limits

Every response will carry the current limit state in its headers:

```text theme={null}
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 57
X-RateLimit-Reset: 1735689600
```

Exceeding the limit returns `429`, with a `Retry-After` header telling you how long to wait.

<Warning>
  Back off when you receive a `429` rather than retrying immediately. Hammering a rate-limited endpoint can get a key suspended.
</Warning>

## Overages

Behaviour once a quota is exhausted — hard stop versus pay-as-you-go overage — has not been decided yet.

## Managing your plan

API billing will sit alongside your existing subscription rather than being a separate invoice.


## Related topics

- [Account & Billing](/account-billing/overview.md)
- [Managing Your Subscription](/account-billing/your-subscription/managing-your-subscription.md)
- [PSNTools API](/api/overview.md)
- [Change your password](/account-billing/your-account/change-password.md)
- [Create a PSNTools account](/account-billing/your-account/create-account.md)