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

# Usage

> Check credits and rate limits for a single key or for the whole organization.

Anona meters every operation in credits and enforces a per-minute rate limit. These
endpoints report where you stand.

| Method and path           | Scope                              | Returns                                                            |
| ------------------------- | ---------------------------------- | ------------------------------------------------------------------ |
| `GET /v1/usage/me`        | The calling API key's organization | Current credit balance and rate limit.                             |
| `GET /v1/usage`           | Organization                       | Credit usage over a period, with a time series.                    |
| `GET /v1/usage/breakdown` | Organization                       | Per-operation breakdown across record, retrieve, reason, and chat. |

## Key usage

A lightweight balance check to run from inside your application.

```bash theme={null}
GET https://api.anonalabs.com/v1/usage/me
Authorization: Bearer anona_live_...
```

```json theme={null}
{
  "credits_remaining": 1487233,
  "credits_limit": 1500000,
  "credits_used": 12767,
  "rate_limit_per_min": 2000
}
```

## Response headers

Live limits are also returned on every API response, so you can track them without an
extra call.

| Header                  | Meaning                                   |
| ----------------------- | ----------------------------------------- |
| `X-RateLimit-Limit`     | Requests allowed in the current window.   |
| `X-RateLimit-Remaining` | Requests left in the current window.      |
| `X-RateLimit-Window`    | Length of the window.                     |
| `X-Credits-Remaining`   | Credits left on the organization's quota. |

## Organization usage

`GET /v1/usage` and `GET /v1/usage/breakdown` both accept a period window and back the
usage views in the dashboard.

## Next steps

<CardGroup cols={2}>
  <Card title="Billing" icon="credit-card" href="/api-reference/billing">
    Plans, credit costs, and subscription management.
  </Card>

  <Card title="Errors" icon="circle-exclamation" href="/api-reference/errors">
    What happens when a quota runs out.
  </Card>
</CardGroup>